PHP 魔術方法在特定情境自動觸發,掌握它們能靈活實現屬性/方法重載、序列化控制、物件字串化等進階功能。本文整理 11 種魔術方法的觸發時機、參數與典型用法。
| 方法 | 觸發時機 | 參數 | 回傳/用途 |
|---|---|---|---|
__construct | 物件實例化時 | 任意 | 初始化 |
__destruct | 物件銷毀前 | 無 | 清理資源 |
__call | 呼叫不可見/不存在的實例方法 | $method, $args | 方法重載 |
__callStatic | 呼叫不可見/不存在的靜態方法 (PHP 5.3+) | $method, $args | 靜態方法重載 |
__get | 讀取不可見/不存在屬性 | $name | 屬性值 |
__set | 寫入不可見/不存在屬性 | $name, $value | 無 |
__isset | 對不可見屬性呼叫 isset() | $name | bool |
__unset | 對不可見屬性呼叫 unset() | $name | 無 |
__sleep | serialize() 前 | 無 | 應序列化的屬性名陣列 |
__wakeup | unserialize() 後 | 無 | 重建資源(如 DB 連線) |
__toString | 物件當字串使用 | 無 | 字串 |
__set_state | var_export() 時 (PHP 5.1+) | $array | 物件實例 |
__clone | clone 物件時 | 無 | 深層複製初始化 |
__autoload | 類未定義時嘗試載入 (已棄用,建議用 spl_autoload_register) | $class | 無 |
__invoke | 物件當函數呼叫 (PHP 5.3+) | 任意 | 任意 |
public;__callStatic 並需加 static。spl_autoload_register() 註冊多個自動載入器。echo/print 觸發,5.2+ 任何字串語境(如 printf('%s', $obj))均觸發;若未實作會拋 E_RECOVERABLE_ERROR。<?php
class Entity {
private $data = [];
public function __get($name) {
return $this->data[$name] ?? null;
}
public function __set($name, $value) {
if ($name === 'id') throw new Exception('ID 唯讀');
$this->data[$name] = $value;
}
}
$e = new Entity();
$e->name = 'Test'; // 觸發 __set
echo $e->name; // 觸發 __get
?>