核心概念
| 魔術方法 | 觸發時機 | 主要用途 |
__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
常見錯誤
- 建構子做太多事:違反單一職責、難以測試、耦合具體實作
- 解構子依賴其他物件:該物件可能已被銷毀,順序不定
- 忘記呼叫 parent::__construct():導致父類初始化邏輯缺失
- 在解構子中使用 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) . " 銷毀");
}
}