Laravel Contracts 詳解：接口驅動的鬆耦合架構核心

什麼是 Contracts？

Laravel Contracts 是一組 **定義框架核心服務的介面**。每個 Contract 對應一項核心功能 (認證、快取、路由、佇列等)，框架內建提供具體實作，開發者可自行替換。

Contracts 完整清單 (常用)

實戰：自訂 Registrar 實作

1. 綁定介面至具體實作

<?php
// App\Providers\AppServiceProvider.php
namespace App\Providers;

use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    public function register()
    {
        $this->app->bind(
            \Illuminate\Contracts\Auth\Registrar::class,
            \App\Services\Registrar::class
        );
    }
}

2. 實作介面

<?php
// App\Services\Registrar.php
namespace App\Services;

use App\Models\User;
use Illuminate\Contracts\Auth\Registrar as RegistrarContract;
use Illuminate\Support\Facades\Validator;

class Registrar implements RegistrarContract
{
    public function validator(array $data)
    {
        return Validator::make($data, [
            'name' => 'required|max:255',
            'email' => 'required|email|max:255|unique:users',
            'password' => 'required|confirmed|min:6',
        ]);
    }

    public function create(array $data)
    {
        return User::create([
            'name' => $data['name'],
            'email' => $data['email'],
            'password' => bcrypt($data['password']),
        ]);
    }
}

3. 控制器透過型別提示自動注入

<?php
// App\Http\Controllers\Auth\AuthController.php
namespace App\Http\Controllers\Auth;

use App\Http\Controllers\Controller;
use Illuminate\Contracts\Auth\Guard;
use Illuminate\Contracts\Auth\Registrar;

class AuthController extends Controller
{
    public function __construct(Guard $auth, Registrar $registrar)
    {
        $this->auth = $auth;
        $this->registrar = $registrar;
        $this->middleware('guest', ['except' => 'getLogout']);
    }
    
    public function postRegister(Request $request)
    {
        $validator = $this->registrar->validator($request->all());
        if ($validator->fails()) {
            $this->throwValidationException($request, $validator);
        }
        $this->auth->login($this->registrar->create($request->all()));
        return redirect($this->redirectPath());
    }
}

核心優勢：鬆耦合

緊耦合範例 (反模式)

<?php
namespace App\Orders;

class Repository
{
    public function __construct(\SomePackage\Cache\Memcached $cache) // 綁定具體實作
    {
        $this->cache = $cache;
    }
}

問題：換 Redis 需修改建構子、所有使用處、可能涉及多個檔案。

Contracts 解耦合

<?php
namespace App\Orders;

use Illuminate\Contracts\Cache\Repository as Cache;

class Repository
{
    public function __construct(Cache $cache) // 綁定介面
    {
        $this->cache = $cache;
    }
}

優勢：

• **實作細節隔離**：不關心底層是 Memcached、Redis、Database、Array
• **單一職責**：類別只依賴「快取行為」，不依賴「快取實作」
• **可測試性**：單元測試輕鬆 Mock 介面，無需啟動真實快取服務
• **開閉原則**：擴展新快取驅動無需修改業務代碼

次要優勢：簡單性與文檔化

• 介面方法簽名即為**服務契約文檔**，閱讀介面即知功能邊界
• 統一規範：所有核心服務皆有對應 Contract，學習成本低
• IDE 智能提示完整支援介面方法

何時使用 Contracts？

Contracts vs Facades

總結

Laravel Contracts 是 **「面向介面編程」在框架層面的標準化落地**。掌握 Contracts 使用，意味著你能：

1. 編寫**可替換、可測試、可維護**的核心業務代碼
2. 開發**高品質擴展包**，讓使用者自由選擇實作
3. 理解框架**解耦合設計哲學**，避免「一切皆 Facade」的緊耦合陷阱

建議：核心領域服務、Repository、跨模組依賴 **優先使用 Contracts 注入**；控制器、臨時腳本、視圖佈局可繼續使用 Facades。

1. 上一篇文章： 使用 GDB 調試 PHP 死循環：從 CPU 100% 到定位具體代碼行
2. 下一篇文章： PHP 列印實心與空心菱形：演算法解析與優化實作

PHP 綜合知識

PHP 官方源碼疑遭污染：Wiki 賬號被盜，建議暫緩下載 5.3.6 及以上版本

事件回顧 2010 年 3 月 25 日，PHP 官方網站發

ExtJS + PHP + MySQL 實現用戶註冊：表單驗證、AJAX 提交、數據庫落地完整示例

數據庫準備 CREATE DATABASE db_regis

PHP 異常機制底層原理：ZEND_HANDLE_EXCEPTION、try-catch 流程與 set_exception_handler 失效的真相

核心問題 getMessage(); }); require

PHP cURL 入門完全指南：從基礎到多執行緒批次處理

為何選擇 cURL 支援多種協定（HTTP、HTTPS、F