萬盛學電腦網

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

PHP 魔術方法完整指南:__get/__set、__call/__callStatic、__toString、__invoke 實戰範例

PHP 魔術方法以雙底線開頭,在特定情境自動觸發,賦予物件動態行為能力。本文系統講解 6 大常用魔術方法的觸發條件、參數與實戰範例。

1. __get / __set:屬性存取攔截

訪問**不存在**或**不可見**屬性時觸發。

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

2. __call / __callStatic:方法呼叫攔截

呼叫**不存在**或**不可見**的實例/靜態方法時觸發。

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

3. __toString:物件轉字串

直接 echo $obj 或字串語境使用物件時觸發,**必須回傳字串**,否則拋出 Catchable fatal error。

class Object {
    public function __toString() {
        return __CLASS__;
    }
}
echo new Object(); // 輸出: Object

4. __invoke:物件當函數呼叫

嘗試將物件當作函數執行 $obj() 時觸發。

class Object {
    public function __invoke($param) {
        var_dump($param);
        return 'invoke';
    }
}
$obj = new Object();
echo $obj('test'); // 輸出: string(4) "test" 然後 invoke

5. __sleep / __wakeup:序列化攔截(補充)

class Object {
    public $bigData;
    public function __sleep() {
        return ['bigData']; // 僅序列化指定屬性
    }
    public function __wakeup() {
        // 反序列化後重建資源連線等
    }
}

6. __clone:複製攔截(補充)

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 7.0+),避免隱性 Bug
  • 文件化所有動態行為,否則維護極度困難

魔術方法是 PHP 物件模型的進階杠桿,用得好能構建優雅的 DSL 與框架核心;用不好則製造難以除錯的「黑魔法」。

copyright © 萬盛學電腦網 all rights reserved