PHP 魔術方法 __call 與 __callStatic 詳解與實戰範例

版本需求

PHP 5.3+ 引入 __callStatic，配合既有的 __call，完整覆蓋實例與靜態方法的動態攔截。

方法簽名與觸發時機

實戰範例：動態屬性存取器

<?php
class Member {
    protected $data = [];

    public function __call($func, $args) {
        // 解析 set_xxx / get_xxx
        $parts = explode('_', $func, 2);
        if (count($parts) !== 2) return null;
        [$type, $key] = $parts;

        if (!in_array($type, ['set', 'get']) || $key === '') return null;

        switch ($type) {
            case 'set':
                $this->data[$key] = $args[0] ?? null;
                break;
            case 'get':
                return $this->data[$key] ?? null;
        }
    }

    // 靜態版本同理
    public static function __callStatic($func, $args) {
        // 可實作靜態快取、單例存取等
    }
}

class User extends Member {
    public function show() {
        foreach ($this->data as $k => $v) echo "$k: $v<br>";
    }
}

class Profession extends Member {
    public function show() {
        foreach ($this->data as $k => $v) echo "$k: $v<br>";
    }
}

// 使用
$user = new User();
$user->set_name('fdipzone');
$user->set_age(29);
$user->show(); // name: fdipzone / age: 29

$pro = new Profession();
$pro->set_profession('IT SERVICE');
$pro->set_price(2500);
$pro->show();

進階應用場景

• 動態代理/委派：將方法呼叫轉發至內部物件 (如 ORM 的 Model::__call 處理關聯)。
• 流暢介面建構器：$query->whereName('John')->orderByDate()->limit(10) 透過 __call 動態組合 SQL。
• 靜態工廠：User::createFromArray([...]) 由 __callStatic 解析並實例化。
• API 客戶端：$client->getUsers() 自動對應 GET /users。

效能與維護性權衡

• ✅ 靈活、減少樣板代碼、支援 DSL 風格 API。
• ❌ 無 IDE 自動完成、靜態分析工具難以追蹤、呼叫堆疊多一層、拼寫錯誤只能運行時發現。
• 建議：核心領域模型盡量顯式定義方法；邊緣適配層 (API 客戶端、查詢建構器、動態屬性包裝) 適度使用。

結語

__call / __callStatic 是 PHP 元編程的利器，賦予類別「方法不存在時的第二次機會」。善用於基礎設施層、適配器、建構器等穩定介面之上，能大幅提升開發體驗；濫用於業務核心則會犧牲可維護性。理解其觸發條件與參數結構，是駕馭動態特性的前提。