Contracts|laravel 8.X

Contracts

介绍
Laravel 的契约是一组接口，它们由框架提供并定义了核心服务。例如，illuste\Contracts\Queue\Queue 契约定义了排队作业所需的方法，而 illuste\Contracts\Mail\Mailer 契约定义了发送邮件所需的方法。

每个契约都有由框架提供的相应实现。例如，Laravel 提供了一个包含各种驱动程序的队列实现，还有一个由 SwiftMailer 提供支持的邮件程序实现等等。

所有的 Laravel 契约都存在于 它们各自的 GitHub 仓库。这为所有可用的契约提供了一个快速的参考点，以及一个可以被包开发人员使用的独立的包。

契约 Vs. Facades
Laravel 的 Facades 和辅助函数提供了一种利用 Laravel 服务的简单方法，无需类型提示并可以从服务容器中解析契约。 在大多数情况下，每个 Facade 都有一个等效的契约。

和 Facades（它不要求您在类的构造函数中引入它们）不同，契约允许您为类定义显式依赖关系。 一些开发人员更喜欢以这种方式显式定义其依赖项，所以更喜欢使用契约，而其他开发人员则享受 Facade 带来的便利。

技巧：无论您更喜欢 Facads 还是契约，大多数应用都运行得不错。但是，如果要构建程序包，则应强烈考虑使用契约，因为它们在程序包上下文中更容易测试。

何时使用契约
正如在其他地方所讨论的，使用契约或 Facades 的许多决定将取决于个人喜好和开发团队的喜好。契约和 Facades 均可用于创建功能强大且经过良好测试的 Laravel 应用程序。 只要聚焦在类的职责应该单一上，您会发现使用契约还是 Facades 之间的实际差异其实很小。

但是，您可能仍然对契约有几个疑问。 例如，为什么要使用接口？ 使用接口不是更复杂吗？ 让我们将使用接口的原因归纳为以下标题：松耦合和简单性。

松耦合
首先，让我们回顾一些与缓存实现紧密耦合的代码。考虑以下：

```

<?php

namespace App\Orders;

class Repository
{
    /**
     * 缓存实例
     */
    protected $cache;

/**
     * 创建一个新的仓库实例
     *
     * @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)) {
            //
        }
    }
}
```

在这个类中，代码与给定的缓存实现紧密耦合。它的紧密耦合是因为我们依赖了包供应商提供的具体缓存类。如果这个包的 API 改变了，我们的代码也必须改变。

同样地，如果我们想把底层缓存技术 (Memcached) 替换为另一种技术 (Redis)，我们将不得不再次修改我们的代码库。我们的代码库不应该有太多关于谁在为它们提供数据或它们如何提供数据的知识。

与这种方法不同，我们可以通过依赖一个简单的、与供应商无关的界面来改进我们的代码：

```

<?php

namespace App\Orders;

use Illuminate\Contracts\Cache\Repository as Cache;

class Repository
{
    /**
     * 缓存实例
     */
    protected $cache;

/**
     * 创建一个新的仓库实例
     *
     * @param  Cache  $cache
     * @return void
     */
    public function __construct(Cache $cache)
    {
        $this->cache = $cache;
    }
}
```

现在，该代码尚未耦合到任何特定的供应商，甚至 Laravel。 由于契约包不包含任何实现且没有依赖关系，因此您可以轻松地编写任何给定契约的替代实现，从而使您可以替换缓存实现，而无需修改任何消费缓存的代码。

简单性
当 Laravel 的所有服务都被整齐地定义在简单的接口中时，很容易确定给定服务提供的功能。契约是框架功能的简明文档。。

此外，当您依赖简单的接口时，您的代码更容易理解和维护。您可以引用一个简单、干净的接口，而不是跟踪大型、复杂的类中有哪些方法可用。

如何使用契约
那么，如何实现契约呢？它其实很简单。

Laravel 中的许多类都是通过 服务容器 解析的，包括控制器、事件侦听器、中间件、队列任务，甚至路由闭包。因此，要实现契约，您只需在被解析的类的构造函数中「类型提示」接口。

例如，查看此事件侦听器：

```

<?php

namespace App\Listeners;

use App\Events\OrderWasPlaced;
use App\Models\User;
use Illuminate\Contracts\Redis\Factory;

class CacheOrderInformation
{
    /**
     * Redis 工厂实现
     */
    protected $redis;

/**
     * 创建一个事件处理实例
     *
     * @param  Factory  $redis
     * @return void
     */
    public function __construct(Factory $redis)
    {
        $this->redis = $redis;
    }

/**
     * 处理事件
     *
     * @param  OrderWasPlaced  $event
     * @return void
     */
    public function handle(OrderWasPlaced $event)
    {
        //
    }
}

```

当解析事件侦听器时，服务容器将读取类的构造函数上的类型提示，并注入适当的值。 要了解更多有关在服务容器中注册内容的信息，请查看 其文档。

契约参考
下表提供了所有 Laravel 契约及其等效 Facades 的快速参考：

|契约	|参考 Facade|
|-----|-----|
| Illuminate\Contracts\Auth\Access\Authorizable	 ||
| Illuminate\Contracts\Auth\Access\Gate	|Gate|
| Illuminate\Contracts\Auth\Authenticatable	 ||
| Illuminate\Contracts\Auth\CanResetPassword|	| 
| Illuminate\Contracts\Auth\Factory	|Auth|
| Illuminate\Contracts\Auth\Guard	|Auth::guard()|
| Illuminate\Contracts\Auth\PasswordBroker	|Password::broker()|
| Illuminate\Contracts\Auth\PasswordBrokerFactory	|Password|
| Illuminate\Contracts\Auth\StatefulGuard||	 
| Illuminate\Contracts\Auth\SupportsBasicAuth	|| 
| Illuminate\Contracts\Auth\UserProvider	|| 
| Illuminate\Contracts\Bus\Dispatcher	|Bus|
| Illuminate\Contracts\Bus\QueueingDispatcher	|Bus::dispatchToQueue()|
| Illuminate\Contracts\Broadcasting\Factory	|Broadcast|
| Illuminate\Contracts\Broadcasting\Broadcaster	|Broadcast::connection()|
| Illuminate\Contracts\Broadcasting\ShouldBroadcast	|| 
| Illuminate\Contracts\Broadcasting\ShouldBroadcastNow	 ||
| Illuminate\Contracts\Cache\Factory	|Cache|
| Illuminate\Contracts\Cache\Lock	 ||
| Illuminate\Contracts\Cache\LockProvider	|| 
| Illuminate\Contracts\Cache\Repository	|Cache::driver()|
| Illuminate\Contracts\Cache\Store	|| 
| Illuminate\Contracts\Config\Repository	|Config|
| Illuminate\Contracts\Console\Application	|| 
| Illuminate\Contracts\Console\Kernel|	Artisan|
| Illuminate\Contracts\Container\Container	|App|
| Illuminate\Contracts\Cookie\Factory|	Cookie|
| Illuminate\Contracts\Cookie\QueueingFactory	|Cookie::queue()|
| Illuminate\Contracts\Database\ModelIdentifier	 ||
| Illuminate\Contracts\Debug\ExceptionHandler	|| 
| Illuminate\Contracts\Encryption\Encrypter	|Crypt|
| Illuminate\Contracts\Events\Dispatcher	|Event|
| Illuminate\Contracts\Filesystem\Cloud	|Storage::cloud()|
| Illuminate\Contracts\Filesystem\Factory|	Storage|
| Illuminate\Contracts\Filesystem\Filesystem	|Storage::disk()|
| Illuminate\Contracts\Foundation\Application|	App|
| Illuminate\Contracts\Hashing\Hasher	|Hash|
| Illuminate\Contracts\Http\Kernel	 ||
| Illuminate\Contracts\Mail\MailQueue|	Mail::queue()|
| Illuminate\Contracts\Mail\Mailable	|| 
| Illuminate\Contracts\Mail\Mailer	|Mail|
| Illuminate\Contracts\Notifications\Dispatcher	|Notification|
| Illuminate\Contracts\Notifications\Factory	|Notification|
| Illuminate\Contracts\Pagination\LengthAwarePaginator	 ||
| Illuminate\Contracts\Pagination\Paginator	 ||
| Illuminate\Contracts\Pipeline\Hub	 ||
| Illuminate\Contracts\Pipeline\Pipeline||	 
| Illuminate\Contracts\Queue\EntityResolver	 ||
| Illuminate\Contracts\Queue\Factory	|Queue|
| Illuminate\Contracts\Queue\Job	|| 
| Illuminate\Contracts\Queue\Monitor	|Queue|
| Illuminate\Contracts\Queue\Queue|	Queue::connection()|
| Illuminate\Contracts\Queue\QueueableCollection	|| 
| Illuminate\Contracts\Queue\QueueableEntity	 ||
| Illuminate\Contracts\Queue\ShouldQueue	|| 
| Illuminate\Contracts\Redis\Factory	|Redis|
| Illuminate\Contracts\Routing\BindingRegistrar	|Route|
| Illuminate\Contracts\Routing\Registrar	|Route|
| Illuminate\Contracts\Routing\ResponseFactory	|Response|
| Illuminate\Contracts\Routing\UrlGenerator	|URL|
| Illuminate\Contracts\Routing\UrlRoutable	 ||
| Illuminate\Contracts\Session\Session	|Session::driver()|
| Illuminate\Contracts\Support\Arrayable	|| 
| Illuminate\Contracts\Support\Htmlable	 ||
| Illuminate\Contracts\Support\Jsonable	|| 
| Illuminate\Contracts\Support\MessageBag||	 
| Illuminate\Contracts\Support\MessageProvider	|| 
| Illuminate\Contracts\Support\Renderable	||
| Illuminate\Contracts\Support\Responsable	 ||
| Illuminate\Contracts\Translation\Loader	|| 
| Illuminate\Contracts\Translation\Translator	|Lang|
| Illuminate\Contracts\Validation\Factory	|Validator|
| Illuminate\Contracts\Validation\ImplicitRule	 ||
| Illuminate\Contracts\Validation\Rule	 ||
| Illuminate\Contracts\Validation\ValidatesWhenResolved	 ||
| Illuminate\Contracts\Validation\Validator	|Validator::make()|
| Illuminate\Contracts\View\Engine	 ||
| Illuminate\Contracts\View\Factory|	View|
| Illuminate\Contracts\View\View	|View::make()|