契约
介绍
Laravel 的契约是一组接口，定义了框架提供的核心服务。例如，Queue 契约定义了队列作业所需的方法，而 Mailer 契约定义了发送电子邮件所需的方法。
每个契约都有框架提供的相应实现。例如，Laravel 提供了具有多种驱动程序的 Queue 实现，以及由 SwiftMailer 驱动的 Mailer 实现。
所有的 Laravel 契约都在 它们自己的 GitHub 仓库 中。这为所有可用契约提供了一个快速参考点，同时也是一个可以被其他包开发者利用的单一、解耦的包。
为什么使用契约？
你可能会有几个关于契约的问题。为什么要使用接口？使用接口不是更复杂吗？
让我们将使用接口的原因归结为以下几个标题：松耦合和简单性。
松耦合
首先，让我们回顾一些与缓存实现紧密耦合的代码。考虑以下代码：
<?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 发生变化，我们的代码也必须更改。
同样，如果我们想用另一种技术（如 Redis）替换我们的底层缓存技术（Memcached），我们又必须修改我们的仓库。我们的仓库不应该对谁提供数据或如何提供数据有太多了解。
相反，我们可以通过依赖一个简单的、与供应商无关的接口来改进我们的代码：
<?php namespace App\Orders;
use Illuminate\Contracts\Cache\Repository as Cache;
class Repository {
/**
* 创建一个新的仓库实例。
*
* @param Cache $cache
* @return void
*/
public function __construct(Cache $cache)
{
$this->cache = $cache;
}
}现在，代码不再与任何特定供应商，甚至 Laravel 耦合。由于契约包不包含实现和依赖项，你可以轻松地编写任何给定契约的替代实现，允许你在不修改任何使用缓存的代码的情况下替换缓存实现。
简单性
当所有的 Laravel 服务都在简单的接口中定义时，很容易确定给定服务提供的功能。契约作为框架功能的简洁文档。
此外，当你依赖简单的接口时，你的代码更易于理解和维护。与其在一个大型复杂的类中追踪可用的方法，不如参考一个简单、干净的接口。
契约参考
这是大多数 Laravel 契约的参考，以及它们的 Laravel 4.x "facade" 对应项：
如何使用契约
那么，如何获得契约的实现呢？其实很简单。Laravel 中的许多类型的类都是通过 服务容器 解析的，包括控制器、事件监听器、过滤器、队列作业，甚至路由闭包。因此，要获得契约的实现，你只需在被解析的类的构造函数中“类型提示”接口。例如，看看这个事件处理程序：
<?php namespace App\Handlers\Events;
use App\User;
use App\Events\NewUserRegistered;
use Illuminate\Contracts\Redis\Database;
class CacheUserInformation {
/**
* Redis 数据库实现。
*/
protected $redis;
/**
* 创建一个新的事件处理程序实例。
*
* @param Database $redis
* @return void
*/
public function __construct(Database $redis)
{
$this->redis = $redis;
}
/**
* 处理事件。
*
* @param NewUserRegistered $event
* @return void
*/
public function handle(NewUserRegistered $event)
{
//
}
}当事件监听器被解析时，服务容器将读取类构造函数上的类型提示，并注入适当的值。要了解有关在服务容器中注册内容的更多信息，请查看 文档。