萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 建構子 __construct 與解構子 __destruct 完整指南:生命週期、依賴注入、資源管理與現代最佳實踐

核心概念

魔術方法觸發時機主要用途
__construct()物件實例化時 (new Class())初始化屬性、建立連線、載入設定、依賴注入
__destruct()物件銷毀時 (引用計數歸零、腳本結束)關閉連線、釋放資源、寫入日誌、解鎖

基本語法與範例

class Database {
    private PDO $pdo;
    private string $dsn;
    
    // 建構子:接收依賴,建立連線
    public function __construct(string $dsn, string $user, string $pass, array $options = []) {
        $this->dsn = $dsn;
        $this->pdo = new PDO($dsn, $user, $pass, $options + [
            PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
            PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
            PDO::ATTR_EMULATE_PREPARES => false,
        ]);
    }
    
    // 解構子:確保連線關閉
    public function __destruct() {
        // PDO 物件銷毀時會自動關閉連線,但顯式關閉更明確
        $this->pdo = null; 
    }
    
    public function query(string $sql, array $params = []): array {
        $stmt = $this->pdo->prepare($sql);
        $stmt->execute($params);
        return $stmt->fetchAll();
    }
}

// 使用
$db = new Database('mysql:host=localhost;dbname=test', 'user', 'pass');
$users = $db->query('SELECT * FROM users WHERE active = 1');
// 腳本結束時自動呼叫 __destruct()

關鍵行為細節

1. 建構子可拋出異常

public function __construct(string $configFile) {
    if (!file_exists($configFile)) {
        throw new InvalidArgumentException("設定檔不存在: $configFile");
    }
    // ...
}

try {
    $service = new Service('/etc/config.json');
} catch (InvalidArgumentException $e) {
    // 物件未建立,__destruct 不會被呼叫
}

2. 解構子不可拋出異常

public function __destruct() {
    try {
        $this->logger->flush(); // 可能拋出異常
    } catch (Throwable $e) {
        // 必須捕獲並記錄,不能拋出
        error_log("解構子錯誤: " . $e->getMessage());
    }
}

3. 循環引用與 GC

class ParentClass {
    public ChildClass $child;
    public function __construct() {
        $this->child = new ChildClass($this); // 循環引用
    }
}

class ChildClass {
    public ParentClass $parent;
    public function __construct(ParentClass $p) { $this->parent = $p; }
    public function __destruct() { echo "Child destruct\n"; }
}

$obj = new ParentClass();
unset($obj); // 立即觸發 __destruct (PHP 5.3+ GC 處理循環引用)

4. 繼承時的呼叫鏈

class Base {
    public function __construct() { echo "Base construct\n"; }
    public function __destruct() { echo "Base destruct\n"; }
}

class Child extends Base {
    public function __construct() {
        parent::__construct(); // 必須手動呼叫父建構子
        echo "Child construct\n";
    }
    public function __destruct() {
        echo "Child destruct\n";
        parent::__destruct(); // 必須手動呼叫父解構子
    }
}
// 輸出順序:Base construct → Child construct → Child destruct → Base destruct

現代最佳實踐

1. 依賴注入 (DI) 容器管理生命週期

// 不要在建構子做重度 I/O (資料庫連線、HTTP 請求)
// 改用 Lazy Loading 或 Factory
class UserService {
    private ?Database $db = null;
    
    public function getDb(): Database {
        return $this->db ??= Database::createFromConfig(); // 延遲初始化
    }
}

2. 使用介面定義契約

interface ConnectionInterface {
    public function connect(): void;
    public function disconnect(): void;
}

class MySqlConnection implements ConnectionInterface {
    public function __construct(private string $dsn) {}
    public function connect() { /* ... */ }
    public function disconnect() { /* ... */ }
    public function __destruct() { $this->disconnect(); }
}

3. 資源管理模式:Disposable / using (PHP 8.1+)

// PHP 8.1+ 可實作 \Disposable 介面 (實驗性)
// 或使用 Symfony 的 ServiceSubscriber、Laravel 的 Service Container

常見錯誤

  1. 建構子做太多事:違反單一職責、難以測試、耦合具體實作
  2. 解構子依賴其他物件:該物件可能已被銷毀,順序不定
  3. 忘記呼叫 parent::__construct():導致父類初始化邏輯缺失
  4. 在解構子中使用 session、資料庫連線:請求結束時這些資源可能已關閉

除錯技巧

// 追蹤物件生命週期
class Debuggable {
    public function __construct() {
        error_log(get_class($this) . " 建立 @ " . debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2)[1]['function'] ?? 'unknown');
    }
    public function __destruct() {
        error_log(get_class($this) . " 銷毀");
    }
}
copyright © 萬盛學電腦網 all rights reserved