PHP 魔術方法實現屬性存取控制與容錯機制

PHP 魔術方法實現屬性存取控制與容錯

利用 `__get`、`__set`、`__isset`、`__unset` 四個魔術方法，可攔截不可見屬性的存取，實現白名單控制、資料驗證、唯讀屬性、動態屬性等進階功能。本文透過完整類別範例展示實作細節。

完整類別代碼

<?php
class Person {
    public $name;
    private $age;

    public function __construct($name, $age) {
        $this->name = $name;
        $this->age = $age;
    }

    // 讀取攔截：僅允許讀取 $age
    public function __get($param) {
        $allow = ['age'];
        if (in_array($param, $allow)) {
            return $this->$param;
        }
        return null; // 或拋出異常
    }

    // 寫入攔截：僅允許寫入 $age、$money
    public function __set($name, $val) {
        $allow = ['age', 'money'];
        if (in_array($name, $allow)) {
            $this->$name = $val;
        }
    }

    // isset()/empty() 攔截
    public function __isset($name) {
        return isset($this->$name);
    }

    // unset() 攔截：僅允許刪除 $tail
    public function __unset($name) {
        $allow = ['tail'];
        if (in_array($name, $allow)) {
            echo 'unset running
';
            unset($this->$name);
        }
    }
}

// 測試
$p = new Person('zp', 21);
$p->age = 200;           // 允許寫入私有屬性
echo $p->money = 200000000; // 動態建立 money 屬性
$p->tail = "a";          // 動態建立 tail

var_dump(isset($p->name));  // true (public)
var_dump(isset($p->age));   // true (經由 __isset)
var_dump(isset($p->money)); // true (動態屬性)

unset($p->tail);           // 觸發 __unset，輸出 "unset running"
// unset($p->age);         // 不在允許列表，靜默忽略
?>

執行結果解析

1. `$p->age = 200`：觸發 `__set`，`age` 在允許列表，寫入成功。
2. `$p->money = 200000000`：觸發 `__set`，`money` 在允許列表，動態建立公有屬性並輸出值。
3. `$p->tail = "a"`：`tail` 不在 `__set` 允許列表，**靜默忽略**，但 PHP 會動態建立公有屬性 `$p->tail`（魔術方法不攔截公有屬性寫入）。
4. `isset($p->age)`：觸發 `__isset`，返回 `true`。
5. `unset($p->tail)`：觸發 `__unset`，`tail` 在允許列表，刪除成功並輸出提示。

核心應用場景

注意事項與最佳實踐

1. 效能：魔術方法比直接存取慢，高頻熱點路徑建議改用 Getter/Setter。
2. 遞迴風險：`__get` 內若存取不存在屬性會再次觸發 `__get`，需檢查 `property_exists()`。
3. 繼承行為：子類若重寫魔術方法，父類邏輯不會自動執行，需手動 `parent::__get()`。
4. 序列化影響：動態屬性會被 `serialize()` 包含，`__sleep` 可控制。
5. IDE 支援：使用 `@property` 註解讓 IDE 識別動態屬性。

進階：結合 `__call` 實現方法級代理

public function __call($method, $args) {
    if (str_starts_with($method, 'get')) {
        $prop = lcfirst(substr($method, 3));
        return $this->__get($prop);
    }
    if (str_starts_with($method, 'set')) {
        $prop = lcfirst(substr($method, 3));
        return $this->__set($prop, $args[0]);
    }
    throw new BadMethodCallException("Method $method not found");
}

善用魔術方法能大幅減少樣板代碼，實現靈活的物件行為控制，但需權衡可讀性與效能。