概述

Laravel 的 Contracts 是一組定義了框架核心服務(wù)的接口（ interfaces ）浓体。 例如Illuminate\Contracts\Queue\Queue 契約定義了隊列任務(wù)需要實(shí)現(xiàn)的方法备恤，Illuminate\Contracts\Mail\Mailer 契約定義了發(fā)送郵件所需要實(shí)現(xiàn)的方法棍丐。

每一個契約都有框架提供的相應(yīng)實(shí)現(xiàn)频祝。例如，Laravel 為隊列提供了多個驅(qū)動的實(shí)現(xiàn)田晚，郵件則由 SwiftMailer 驅(qū)動實(shí)現(xiàn) 嘱兼。

所有 Laravel 契約都有其對應(yīng)的GitHub庫，這為所有有效的契約提供了快速入門指南贤徒，同時也可以作為獨(dú)立、解耦的包被包開發(fā)者使用汇四。當(dāng)程序變得越來大接奈，這種通過合同或者接口來解耦所帶來的可擴(kuò)展性和可維護(hù)性是無可比擬的。

使用Contracts后

上圖不使用Contracts的情況下通孽，對于一種邏輯序宦，我們只能得到一種結(jié)果（方塊），如果變更需求背苦，意味著我們必須重構(gòu)代碼和邏輯互捌。但是在使用Contracts的情況下，我們只需要按照接口寫好邏輯行剂，然后提供不同的實(shí)現(xiàn)秕噪，就可以在不改動代碼邏輯的情況下獲得更加多態(tài)的結(jié)果。

契約（Contracts） Vs. 門面（Facades）

Laravel 門面為 Laravel 服務(wù)的使用提供了便捷方式——不再需要從服務(wù)容器中類型提示 和 契約(Contracts)解析即可直接通過靜態(tài) 門面(Facade) 調(diào)用厚宰。

不同于 門面(Facade) 不需要再構(gòu)造器中進(jìn)行類型提示腌巾，契約(Contracts) 允許你在類中定義顯式的依賴。有些開發(fā)者喜歡門面(Facade)帶來的便捷铲觉，也有些開發(fā)者傾向于使用契約(Contracts)澈蝙，他們喜歡定義明確的依賴。

注：大多數(shù)應(yīng)用中撵幽，不管你使用門面還是契約灯荧，合適就好。不過盐杂，如果你是在構(gòu)建一個擴(kuò)展包逗载，那么就應(yīng)該使用契約，因?yàn)楦菀诇y試况褪。

何時使用契約

為什么要定義接口

定義接口目的為了解耦

使用接口的優(yōu)點(diǎn)：松耦合和簡單撕贞。
首先，讓我們看看一些緩存實(shí)現(xiàn)的緊耦合代碼：

<?php

namespace App\Orders;

class Repository
{
    /**
     * 緩存
     */
    protected $cache;

    /**
     * 創(chuàng)建一個新的Repository實(shí)例
     *
     * @param  \SomePackage\Cache\Memcached  $cache
     * @return void
     */
    public function __construct(\SomePackage\Cache\Memcached $cache)
    {
        $this->cache = $cache;
    }

    /**
     * 通過ID獲取訂單
     *
     * @param  int  $id
     * @return Order
     */
    public function find($id)
    {
        if ($this->cache->has($id))    {
            //
        }
    }
}

問題
在這個類中测垛，代碼和給定緩存實(shí)現(xiàn)緊密耦合捏膨，由于我們基于一個來自包的具體的緩存類，如果包的API變了，那么相應(yīng)的号涯，我們的代碼必須做修改目胡。

類似的，如果我們想要替換底層的緩存技術(shù)（Memcached）為別的技術(shù)實(shí)現(xiàn)（Redis）链快，我們將再一次不得不修改我們的代碼庫誉己。我們的代碼庫應(yīng)該并不知道誰提供的數(shù)據(jù)或者數(shù)據(jù)是怎么提供的。

我們可以創(chuàng)建一個簡單的域蜗、與提供者無關(guān)的接口：

namespace App\Contracts;
use Closure;
interface Repository
{
    public function setTag($tag);
    public function setTime($time_in_minute);
    public function remember($key, Closure $entity, $tag = null);
    public function forget($key, $tag = null);
    public function clearCache($tag = null);
    public function clearAllCache();
}

然后再利用容器的綁定巨双，根據(jù)不同的配置，返回不同的實(shí)現(xiàn):

public function register()
{
        $this->app->bind('Repository', function ($app) {
            if (config('cache.enable') == 'true') {
                return new Memcached();
            } else {
                return new Redis();
            }
        });
}

我們可以基于一種簡單的霉祸、與提供者無關(guān)的接口來優(yōu)化我們的代碼筑累，從而替代上述那種實(shí)現(xiàn)：

<?php

namespace App\Orders;

use Illuminate\Contracts\Cache\Repository as Cache;

class Repository
{
    /**
     * 創(chuàng)建一個新的Repository實(shí)例
     *
     * @param  Cache  $cache
     * @return void
     */
    public function __construct(Cache $cache)
    {
        $this->cache = $cache;
    }
}

現(xiàn)在代碼就不與任何特定提供者耦合，甚至與 Laravel 都是無關(guān)的丝蹭。由于契約包不包含任何實(shí)現(xiàn)和依賴慢宗，你可以輕松的為給定契約編寫可選實(shí)現(xiàn)代碼，你可以隨意替換緩存實(shí)現(xiàn)而不用去修改任何緩存消費(fèi)代碼奔穿。

簡單
當(dāng)所有 Laravel 服務(wù)都統(tǒng)一在簡單接口中定義镜沽，很容易判斷給定服務(wù)提供的功能。契約可以充當(dāng)框架特性的簡明文檔贱田。

此外缅茉，基于簡單接口，代碼也更容易理解和維護(hù)湘换。在一個龐大而復(fù)雜的類中宾舅，與其追蹤哪些方法是有效的，不如轉(zhuǎn)向簡單彩倚、干凈的接口筹我。

如何使用契約

那么，如何實(shí)現(xiàn)契約呢帆离？這很簡單蔬蕊。
Laravel中很多類都是通過服務(wù)容器進(jìn)行解析，包括控制器哥谷，以及監(jiān)聽器岸夯、中間件、隊列任務(wù)们妥，甚至路由閉包猜扮。所以，要實(shí)現(xiàn)一個契約监婶，需要在解析類的構(gòu)造函數(shù)中類型提示這個契約接口旅赢。

<?php

namespace App\Listeners;

use App\User;
use App\Events\OrderWasPlaced;
use Illuminate\Contracts\Redis\Database;

class CacheOrderInformation
{
    /**
     * Redis數(shù)據(jù)庫實(shí)現(xiàn)齿桃。
     */
    protected $redis;

    /**
     * 創(chuàng)建一個新的事件處理器實(shí)例。
     *
     * @param  Database  $redis
     * @return void
     */
    public function __construct(Database $redis)
    {
        $this->redis = $redis;
    }

    /**
     * 處理事件煮盼。
     *
     * @param  OrderWasPlaced  $event
     * @return void
     */
    public function handle(OrderWasPlaced $event)
    {
        //
    }
}

事件監(jiān)聽器被解析的時候短纵，服務(wù)容器會讀取構(gòu)造函數(shù)中的類型提示，并注入適當(dāng)?shù)闹怠?/p>

契約列表

下面是 Laravel 契約列表僵控，以及其對應(yīng)的“門面”：