الهادم (__destruct)

جزء من قسم Object Oriented Programming في رحلة PHP على Coddy — الدرس 8 من 91.

تُعد الطريقة __destruct طريقة خاصة يتم استدعاؤها تلقائيًا عند تدمير الكائن. يتم تدمير الكائن عندما لا تعود هناك أي مراجع تشير إليه أو عند انتهاء السكربت.

إليك مثال على فئة (class) تحتوي على كل من منشئ (constructor) ومدمر (destructor):

<?php
class Resource {
    public $name;

    public function __construct($name) {
        $this->name = $name;
        echo $this->name . " was created\n";
    }

    public function __destruct() {
        echo $this->name . " was destroyed\n";
    }
}

أنشئ كائنًا وراقب دورة حياته:

echo "=== Start ===\n";
$r = new Resource("Connection");
echo "Using " . $r->name . "\n";
unset($r);  // تدمير الكائن بشكل صريح
echo "=== End ===\n";

الناتج:

=== Start ===
Connection was created
Using Connection
Connection was destroyed
=== End ===

تقوم الدالة unset() بإزالة المرجع إلى الكائن، مما يؤدي إلى استدعاء المدمر (destructor) فوراً.

إذا لم تقم باستدعاء unset()، يتم تشغيل المدمر (destructor) تلقائياً عند انتهاء السكريبت:

$r = new Resource("Logger");
echo "Working...\n";
// يتم استدعاء __destruct تلقائياً في نهاية السكريبت

المخرجات:

Logger was created
Working...
Logger was destroyed

نقطة رئيسية: تُعد طريقة __destruct مفيدة لمهام التنظيف مثل إغلاق الملفات، أو تحرير الموارد، أو تسجيل السجلات عندما لا تعود هناك حاجة للكائن.

التحدي

متوسط

أكمل فئة Resource في resource.php:

أضف تابع __construct يأخذ $name، ويقوم بتعيينه كخاصية، ويطبع "[name] was created"
أضف تابع logMessage يأخذ $message ويطبع "Log: [message]"
أضف تابع __destruct يطبع "[name] was destroyed"

سيقوم ملف driver.php باختبار دورة حياة كائنات Resource الخاصة بك.

ورقة مرجعية

يتم استدعاء الطريقة __destruct تلقائيًا عند تدمير الكائن (عندما لا توجد مراجع أخرى له أو عند انتهاء السكريبت).

مثال على فئة (class) تحتوي على منشئ (constructor) ومدمر (destructor):

<?php
class Resource {
    public $name;

    public function __construct($name) {
        $this->name = $name;
        echo $this->name . " was created\n";
    }

    public function __destruct() {
        echo $this->name . " was destroyed\n";
    }
}

تقوم الدالة unset() بإزالة المرجع للكائن، مما يؤدي إلى استدعاء المدمر (destructor) فورًا:

$r = new Resource("Connection");
unset($r);  // تدمير الكائن بشكل صريح

إذا لم يتم استدعاء unset()، فسيتم تشغيل المدمر تلقائيًا عند انتهاء السكريبت.

تعتبر الطريقة __destruct مفيدة لمهام التنظيف مثل إغلاق الملفات، أو تحرير الموارد، أو تسجيل السجلات (logging).

جرّب بنفسك

<?php
require_once 'resource.php';

$testCase = trim(fgets(STDIN));

if ($testCase == "basic_test") {
    echo "=== Start ===\n";
    $r = new Resource("FileHandler");
    echo "Using " . $r->name . "\n";
    unset($r);
    echo "=== End ===\n";
} elseif ($testCase == "auto_destruct_test") {
    $r = new Resource("Logger");
    $r->logMessage("Application started");
}