PHP 魔術方法以雙底線開頭,在特定情境自動觸發,賦予物件動態行為能力。本文系統講解 6 大常用魔術方法的觸發條件、參數與實戰範例。
訪問**不存在**或**不可見**屬性時觸發。
class Object {
protected $data = [];
public function __set($key, $value) {
$this->data[$key] = $value;
}
public function __get($key) {
return $this->data[$key] ?? null;
}
}
$obj = new Object();
$obj->title = 'hello'; // 觸發 __set
echo $obj->title; // 觸發 __get,輸出 hello
呼叫**不存在**或**不可見**的實例/靜態方法時觸發。
class Object {
public function __call($method, $args) {
var_dump($method, $args);
return "magic function\n";
}
public static function __callStatic($method, $args) {
var_dump($method, $args);
return "magic static\n";
}
}
$obj = new Object();
$obj->test('hello', 123); // 觸發 __call
Object::test('hello', 1234); // 觸發 __callStatic
直接 echo $obj 或字串語境使用物件時觸發,**必須回傳字串**,否則拋出 Catchable fatal error。
class Object {
public function __toString() {
return __CLASS__;
}
}
echo new Object(); // 輸出: Object
嘗試將物件當作函數執行 $obj() 時觸發。
class Object {
public function __invoke($param) {
var_dump($param);
return 'invoke';
}
}
$obj = new Object();
echo $obj('test'); // 輸出: string(4) "test" 然後 invoke
class Object {
public $bigData;
public function __sleep() {
return ['bigData']; // 僅序列化指定屬性
}
public function __wakeup() {
// 反序列化後重建資源連線等
}
}
class Object {
public $resource;
public function __clone() {
$this->resource = clone $this->resource; // 深層複製
}
}
| 魔術方法 | 典型用途 |
|---|---|
| __get/__set | 動態屬性、資料映射(ORM)、代理模式 |
| __call/__callStatic | 動態方法、流暢介面、委派模式、RPC 客戶端 |
| __toString | 實體識別顯示、日誌記錄、模板渲染 |
| __invoke | 可呼叫物件、策略模式、中介軟體 |
| __sleep/__wakeup | 序列化控制、敏感資料過濾、資源重連 |
| __clone | 深層複製、單例模式防複製 |
@property、@method 註解讓 IDE 支援自動完成魔術方法是 PHP 物件模型的進階杠桿,用得好能構建優雅的 DSL 與框架核心;用不好則製造難以除錯的「黑魔法」。