Destructor method in PHP - Step-by-Step Execution

Concept Flow - Destructor method

Object Created

↓

Program Runs

↓

Object No Longer Needed

↓

Destructor Called Automatically

↓

Cleanup Actions Executed

↓

Object Destroyed

When an object is no longer needed, PHP automatically calls its destructor method to clean up before the object is destroyed.

Execution Sample

PHP

<?php
class Test {
  function __construct() { echo "Created\n"; }
  function __destruct() { echo "Destroyed\n"; }
}
$obj = new Test();
?>

This code creates an object that prints 'Created' when made and 'Destroyed' when the script ends and the object is destroyed.

Execution Table

Step	Action	Output	Object State
1	Create object $obj	Created	Object exists
2	Script runs, object in use		Object exists
3	Script ends, object no longer needed		Object about to be destroyed
4	Destructor __destruct() called automatically	Destroyed	Object destroyed

💡 Script ends, object destroyed, destructor called automatically

Variable Tracker

Variable	Start	After Creation	After Script End
$obj	undefined	object instance	destroyed (no longer exists)

Key Moments - 3 Insights

Why does the destructor run automatically without calling it?

The destructor is called by PHP automatically when the object is no longer needed, as shown in step 4 of the execution_table.

Can the destructor be called manually like a normal method?

No, the destructor is meant to be called automatically by PHP; calling it manually is not standard practice and can cause unexpected behavior.

What happens if the destructor is missing in the class?

If no destructor is defined, PHP simply destroys the object without running any cleanup code, so no output appears at destruction time.

Visual Quiz - 3 Questions

Look at the execution_table, what is the output when the object is created?

A Destroyed

B Created

C No output

D Error

💡 Hint

Check step 1 in the execution_table where the object is created.

At which step does the destructor method run according to the execution_table?

A Step 3

B Step 2

C Step 4

D Step 1

💡 Hint

Look for the step where 'Destructor __destruct() called automatically' is noted.

If the destructor method is removed from the class, what changes in the output?

A No 'Destroyed' output

B Both 'Created' and 'Destroyed' outputs disappear

C No 'Created' output

D Error occurs

💡 Hint

Refer to key_moments about what happens if destructor is missing.

Concept Snapshot

Destructor method in PHP:
- Defined as __destruct() inside a class
- Runs automatically when object is destroyed
- Used for cleanup tasks
- No need to call manually
- Runs at script end or when object unset

Full Transcript

In PHP, a destructor method named __destruct() runs automatically when an object is no longer needed. When you create an object, the constructor runs first, then your program uses the object. When the script ends or the object is unset, PHP calls the destructor to clean up. This happens without you calling it. If you do not define a destructor, PHP just destroys the object silently. The destructor is useful to close files, release resources, or print messages when the object is destroyed.

Practice

1. What is the purpose of the __destruct method in a PHP class?

easy

A. To clean up resources when an object is destroyed

B. To initialize object properties when created

C. To define a class constant

D. To handle user input validation

Solution

1. Step 1: Understand the role of __destruct

   The __destruct method is called automatically when an object is destroyed or goes out of scope.

2. Step 2: Identify its purpose

   It is used to clean up resources like closing files or database connections safely.

3. Final Answer:

   To clean up resources when an object is destroyed -> Option A

4. Quick Check:

   Destructor method = cleanup on object destruction [OK]

Hint: Destructor cleans up when object is removed from memory [OK]

Common Mistakes:

• Confusing __destruct with __construct
• Thinking it initializes objects
• Using it to handle input validation

2. Which of the following is the correct syntax to declare a destructor method in PHP?

easy

A. function __destruct() {}

B. function destruct() {}

C. function _destruct() {}

D. function __destroy() {}

Solution

1. Step 1: Recall PHP destructor naming

   PHP destructor methods must be named exactly __destruct with two underscores.

2. Step 2: Check syntax correctness

   The correct syntax is function __destruct() {}. Other options have incorrect names.

3. Final Answer:

   function __destruct() {} -> Option A

4. Quick Check:

   Destructor syntax = __destruct() [OK]

Hint: Destructor always starts with double underscores __destruct [OK]

Common Mistakes:

• Using single underscore or wrong method name
• Omitting parentheses in method declaration
• Confusing with __construct method

3. What will be the output of the following PHP code?

class Test {
  function __construct() {
    echo "Constructed\n";
  }
  function __destruct() {
    echo "Destructed\n";
  }
}
$obj = new Test();
echo "Hello\n";
unset($obj);

medium

A. Constructed\nDestructed\nHello\n

B. Hello\nConstructed\nDestructed\n

C. Destructed\nConstructed\nHello\n

D. Constructed\nHello\nDestructed\n

Solution

1. Step 1: Trace object creation and constructor call

   When $obj = new Test(); runs, __construct() prints "Constructed\n".

2. Step 2: Print "Hello" and then unset object

   Next, "Hello\n" is printed. Then unset($obj); destroys the object, triggering __destruct() which prints "Destructed\n".

3. Final Answer:

   Constructed\nHello\nDestructed\n -> Option D

4. Quick Check:

   Constructor then echo then destructor [OK]

Hint: Destructor runs when object is unset or script ends [OK]

Common Mistakes:

• Assuming destructor runs before echo
• Confusing order of constructor and destructor
• Missing that unset triggers destructor immediately

4. Identify the error in this PHP class related to the destructor method:

class Sample {
  function __destruct {
    echo "Cleaning up";
  }
}

medium

A. Destructor must be static

B. Destructor name should be __destroy

C. Missing parentheses in destructor declaration

D. Destructor cannot echo text

Solution

1. Step 1: Check destructor method syntax

   The destructor method must include parentheses even if it has no parameters: function __destruct() {}.

2. Step 2: Identify the missing parentheses error

   The code misses parentheses after __destruct, causing a syntax error.

3. Final Answer:

   Missing parentheses in destructor declaration -> Option C

4. Quick Check:

   Destructor needs () after name [OK]

Hint: Always add () after __destruct method name [OK]

Common Mistakes:

• Omitting parentheses in method declaration
• Using wrong destructor name
• Thinking destructor must be static

5. You want to ensure a file is always closed when your PHP object is destroyed. Which code snippet correctly uses a destructor to do this?

class FileHandler {
  private $file;
  function __construct($filename) {
    $this->file = fopen($filename, 'w');
  }
  // What goes here?
}

hard

A. function __destruct() {
open($this->file);
}

B. function __destruct() {
fclose($this->file);
}

C. function __destruct() {
fclose($filename);
}

D. function __destruct() {
$this->file = null;
}

Solution

1. Step 1: Understand resource cleanup in destructor

   The destructor should close the file resource held in $this->file using fclose().

2. Step 2: Check each option for correctness

   function __destruct() { fclose($this->file); } correctly calls fclose($this->file);. function __destruct() { open($this->file); } tries to open instead of close. function __destruct() { fclose($filename); } uses undefined $filename. function __destruct() { $this->file = null; } just sets property to null without closing.

3. Final Answer:

   function __destruct() { fclose($this->file); } -> Option B

4. Quick Check:

   Destructor closes file resource properly [OK]

Hint: Destructor should close resources like files with fclose() [OK]

Common Mistakes:

• Calling wrong function like open() instead of fclose()
• Using undefined variables inside destructor
• Not actually closing the resource, just nullifying