Laravel5中contracts详解

我们知道，Laravel里面存在着大量的Facade用法，比如你一开始写的router，Router::get() ，你知道为啥可以这样写吗？Router::get() 其实等价于$app->make('router')->get(); $app->make('router') 就是一个很形象的ioc容器， $app->make()就是容器，'router'就是放进去解析的类（的别名），$app->make('router') 就可以把 Route类的一个实例解析出来。

你可能要问，为啥要解析呢？解析是什么意思呢？我New 一下那个类不就可以得到实例了吗？首先，如果你把一个类绑定到Ioc的容器后，它可以自动帮你生成实例，不用include，不用new。其次new 一个类不能直接帮你解析出它依赖的类，特别是接口类，用new的方法你需要先用new创建实例，然后再传入这个类依赖的实例（意味着有更多的new）。

在Laravel5中出现了一个新的东西，叫做contracts，那么它到底是什么？有什么用？怎么用？我们就来探讨下吧。

我们先来看看官方文档中对contracts的定义：

Laravel's Contracts are a set of interfaces that define the core services provided by the framework.

意思是说Laravel的Contracts是一个由 框架提供 的定义了 核心服务接口 的集合。

也就是说，每一个Contract都是一个接口，对应一个框架核心服务。

那它的意义何在？官网给出的解释也很简单：使用接口是为了 松耦合 和 简单 。

先不讲大道理，先来点干货，看看怎么使用contract

先浏览下contracts接口列表：

代码如下:

Illuminate\Contracts\Auth\Guard

Illuminate\Contracts\Auth\PasswordBroker

Illuminate\Contracts\Bus\Dispatcher

Illuminate\Contracts\Cache\Repository

Illuminate\Contracts\Cache\Factory

Illuminate\Contracts\Config\Repository

Illuminate\Contracts\Container\Container

Illuminate\Contracts\Cookie\Factory

Illuminate\Contracts\Cookie\QueueingFactory

Illuminate\Contracts\Encryption\Encrypter

Illuminate\Contracts\Routing\Registrar

…… 太多了，懒得继续贴了，官网手册里有。我们就拿 Illuminate\Contracts\Routing\Registrar 这个contract来演示一下吧。

首先，打开 app/Providers/AppServiceProvider.php，注意register方法：

代码如下:

public function register()

{

$this->app->bind(

'Illuminate\Contracts\Auth\Registrar',

'App\Services\Registrar'

);

}

$this->app 就是Application对象，也是容器对象，通过 $this->app->bind 方法我们绑定了一个实现Illuminate\Contracts\Auth\Registrar接口的类App\Services\Registrar。

注意，Illuminate\Contracts\Auth\Registrar就是一个contract。App\Services\Registrar 这个类文件在 app/Services/Registrar.php。

接着我们看 App\Http\Controllers\Auth\AuthController 这个控制器类，看到它有 __construct 构造函数：

代码如下:

public function __construct(Guard $auth, Registrar $registrar)

{

$this->auth = $auth;

$this->registrar = $registrar;

$this->middleware('guest', ['except' => 'getLogout']);

}

它有两个参数，对应的类命名空间在脚本开头可以看到：

代码如下:

use Illuminate\Contracts\Auth\Guard;

use Illuminate\Contracts\Auth\Registrar;

这两个都是contract，但我们这里就拿 Registrar 说，我们注意到这里面只是通过参数类型指明了$registrar的接口类型，而实际调用的时候实际上是 App\Services\Registrar 这个类，这就是依赖注入的特性了，Laravel会自动在容器中搜索实现了接口Illuminate\Contracts\Auth\Registrar的类或对象，有的话就取出来作为实际参数传到构造函数里。

整个使用流程其实就可以总结为两个步骤：

向容器中注册实现contract接口的对象。

构造函数参数类型指定为contract接口类，框架会自动找到符合条件的对象。

那么再来说说contract的好处。

松耦合

官网给了一个例子解释什么是紧耦合以及Contract接口为何能够松耦合。

先来看看紧耦合的代码：

代码如下:

<?php namespace App\Orders;

class Repository {

/**

* The cache.

*/

protected $cache;

/**

* Create a new repository instance.

*

* @param \SomePackage\Cache\Memcached $cache

* @return void

*/

public function __construct(\SomePackage\Cache\Memcached $cache)

{

$this->cache = $cache;

}

/**

* Retrieve an Order by ID.

*

* @param int $id

* @return Order

*/

public function find($id)

{

if ($this->cache->has($id))

{

//

}

}

}

可以看到构造函数中注入了一个详细的缓存实现 \SomePackage\Cache\Memcached ，如果换Redis作为缓存服务器或者更改了api方法，就需要修改，而如果项目很大，你不知道还有多少地方需要修改。

那么，Contract接口是如何解决这个问题的？请看代码：

代码如下:

<?php namespace App\Orders;

use Illuminate\Contracts\Cache\Repository as Cache;

class Repository {

/**

* Create a new repository instance.

*

* @param Cache $cache

* @return void

*/

public function __construct(Cache $cache)

{

$this->cache = $cache;

}

}

注意，缓存实现我们使用了一个接口，也就是contract，Illuminate\Contracts\Cache\Repository，因为它只是接口，不需要关心背后是memcache还是redis。

简单性

如果所有服务都使用接口定义，就可以很简单的决定一个服务需要的功能，更加容易维护和扩展，并且contract接口还能看作一个简洁的文档便于阅读。