您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP 解構函數 __destruct() 完整指南：資源釋放、善後處理與常見誤區

編輯：PHP 相關知識

解構函數 __destruct() 是物件生命週期的最後一站，常被誤解為「釋放記憶體」。本文釐清其真實作用、適用場景、執行時機與最佳實踐，並對比其他語言差異。

一、核心定位：不是記憶體回收器

PHP 採用引用計數 GC，記憶體釋放由引擎自動管理。
__destruct() 是用戶定義的邏輯鉤子，在物件引用計數歸零（或腳本結束）前自動呼叫。
作用：關閉外部資源、寫入快取、記錄日誌、解鎖、發送通知等「善後工作」。

二、經典應用場景

class FileLogger {
    private $fp;

    public function __construct(string $path) {
        $this->fp = fopen($path, 'a');
        if (!$this->fp) throw new RuntimeException("無法開啟日誌檔案: $path");
    }

    public function log(string $msg) {
        fwrite($this->fp, date('c') . " $msg\n");
    }

    public function __destruct() {
        if (is_resource($this->fp)) {
            fclose($this->fp); // 確保檔案句柄釋放、緩衝區刷新
        }
    }
}

// 使用
$logger = new FileLogger('/var/log/app.log');
$logger->log('用戶登入');
$logger->log('下單成功');
// 腳本結束或 $logger = null 時自動呼叫 __destruct() 關閉檔案

三、執行時機與順序

變數賦值為 null / unset()：引用計數歸零 → 立即觸發。
函數/方法結束：局部變數超出作用域 → 觸發。
腳本結束 (RSHUTDOWN)：全域物件按建立順序逆序銷毀。
異常拋出未捕獲：物件在堆疊展開過程中銷毀 → 觸發。

四、常見誤區與避坑

誤區	真相
__destruct 用來釋放記憶體	PHP 自動管理記憶體，__destruct 只做邏輯清理
一定會執行	致命錯誤、exit()/die()、腳本超時、進程被 kill -9 可能不執行
可在 __destruct 拋出異常	會導致 Fatal Error，應捕獲內部異常或記錄日誌
可訪問其他物件	其他物件可能已銷毀，僅安全訪問純資料屬性
循環引用不會釋放	PHP 5.3+ 循環 GC 會處理，但 __destruct 執行順序不確定

五、進階模式：註冊關閉函數

需確保邏輯絕對執行（即使 exit()），請改用 register_shutdown_function()：

class CriticalTask {
    public function __construct() {
        register_shutdown_function([$this, 'cleanup']);
    }
    public function cleanup() {
        // 即使 exit() 也會執行
        file_put_contents('/tmp/cleanup.log', 'shutdown at ' . date('c'));
    }
}