PHP 物件鏈式操作核心原理深度解析：__call 與 __toString 魔術方法實戰

什麼是鏈式操作？

jQuery 讓我們耳熟能詳：$('p').css('color').addClass('selected')。PHP 中同樣可以實現：$str->trim()->strlen()，比嵌套函式 strlen(trim($str)) 更符合線性閱讀習慣。

核心機制：兩大魔術方法

完整實作範例：字串處理鏈

<?php
/**
 * 鏈式操作基底類
 */
abstract class BaseChainObject {
    private $_traceData = [];
    protected $_methods = [];  // 允許呼叫的方法白名單
    public $data;

    public function __construct($data) {
        $this->data = $data;
        $this->_traceData['__construct'] = $data;
    }

    // 物件轉字串時輸出最終結果
    public function __toString() {
        return (string)$this->data;
    }

    // 攔截不存在的方法呼叫
    public function __call($name, $args) {
        // 白名單驗證
        if (!in_array($name, $this->_methods)) {
            throw new Exception("不允許的方法: $name");
        }

        // 執行對應函式
        $this->data = empty($args)
            ? call_user_func($name, $this->data)
            : call_user_func_array($name, $args);

        $this->_traceData[$name] = $this->data;
        return $this;  // 關鍵：回傳 $this 實現鏈式
    }

    // 除錯：追蹤處理過程
    public function trace() {
        var_dump($this->_traceData);
    }
}

/**
 * 字串處理鏈：僅允許 trim、strlen
 */
class StringChain extends BaseChainObject {
    protected $_methods = ['trim', 'strlen'];
}

// 使用示範
$str = new StringChain('  ab rewqc  ');
echo $str->trim()->strlen();  // 輸出: 8
$str->trace();  // 除錯輸出完整處理軌跡
?>

執行流程圖解

new StringChain('  ab rewqc  ')
       │
       ▼
$str->trim()  ──▶ __call('trim', []) ──▶ trim('  ab rewqc  ') = 'ab rewqc' ──▶ return $this
       │
       ▼
->strlen()    ──▶ __call('strlen', []) ──▶ strlen('ab rewqc') = 8 ──▶ return $this
       │
       ▼
echo $str     ──▶ __toString() ──▶ "8"

另一種實現方式：自定義方法回傳 $this

class FluentString {
    private $str;
    public function __construct($str) { $this->str = $str; }
    public function trim() { $this->str = trim($this->str); return $this; }
    public function upper() { $this->str = strtoupper($this->str); return $this; }
    public function __toString() { return $this->str; }
}

echo (new FluentString(' hello '))->trim()->upper();  // "HELLO"

優缺點對比

實務應用場景

• 查詢建構器（如 Laravel Query Builder）
• 集合/陣列流式處理（如 Laravel Collection）
• 驗證規則鏈、中介軟體管線
• HTML/表單建構器

總結

PHP 物件鏈式操作的本質是：__call 攔截動態呼叫 + 執行邏輯 + 回傳 $this + __toString 輸出結果。理解此原理，不僅能讀懂主流框架核心原始碼，更能設計出優雅的流暢介面 API。