我们先来看看官方文档中对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的类或对象,有的话就取出来作为实际参数传到构造函数里。
新闻热点
疑难解答