鏈式操作(Method Chaining)讓多個方法呼叫串聯成單一陳述式,核心只有一句:return $this;。本文以資料庫查詢建構器為例闡述實作細節。
namespace Common;
class Database {
public function where($condition) {
// 處理條件邏輯...
return $this; // 關鍵:回傳自身實例
}
public function order($order) {
// 處理排序邏輯...
return $this;
}
public function limit($limit) {
// 處理限制邏輯...
return $this;
}
}
$db = new Common\Database();
// 傳統多行呼叫
$db->where('id = 1');
$db->where('name = 2');
$db->order('id desc');
$db->limit(10);
// 鏈式操作:單行完成
$db->where('id = 1')->where('name = 2')->order('id desc')->limit(10);
因每個方法回傳 $this(即 Database 實例),IDE 可正確推導型別,提供後續方法的自動完成提示(如圖所示)。
return $this;get()、execute())回傳實際結果而非 $this@return $this 或 @return static 讓靜態分析工具支援class QueryBuilder {
public static function table($table) {
return (new static())->from($table);
}
// ... where, order, limit 等皆 return $this
public function get() { /* 執行查詢並回傳結果 */ }
}
// 使用
$users = QueryBuilder::table('users')->where('active', 1)->limit(10)->get();
Illuminate\Database\Query\Builderthink\db\QueryQueryBuilderBuilder鏈式操作不僅語法糖,更是流暢介面設計模式的體現,讓 API 閱讀如自然語言,大幅提升開發體驗。