Laravel5中contracts详解


Posted in PHP onMarch 02, 2015

我们先来看看官方文档中对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接口还能看作一个简洁的文档便于阅读。

PHP 相关文章推荐
php class中self,parent,this的区别以及实例介绍
Apr 24 PHP
具有时效性的php加密解密函数代码
Jun 19 PHP
解析PHP对现有搜索引擎的调用
Jun 25 PHP
php连接函数implode与分割explode的深入解析
Jun 26 PHP
php实现按文件名搜索文件的远程文件查找器
May 10 PHP
linux下编译安装memcached服务
Aug 03 PHP
浅谈使用 PHP 进行手机 APP 开发(API 接口开发)
Aug 11 PHP
PHP数组排序之sort、asort与ksort用法实例
Sep 08 PHP
Sublime里直接运行PHP配置方法
Nov 28 PHP
PHP中file_get_contents函数抓取https地址出错的解决方法(两种方法)
Sep 22 PHP
Yii控制器中操作视图js的方法
Jul 04 PHP
PHP+Ajax实现上传文件进度条动态显示进度功能
Jun 04 PHP
php打印一个边长为N的实心和空心菱型的方法
Mar 02 #PHP
初识laravel5
Mar 02 #PHP
避免Smarty与CSS语法冲突的方法
Mar 02 #PHP
实现PHP+Mysql无限分类的方法汇总
Mar 02 #PHP
Java和PHP在Web开发方面对比分析
Mar 01 #PHP
php中return的用法实例分析
Feb 28 #PHP
php多次include后导致全局变量global失效的解决方法
Feb 28 #PHP
You might like
百度工程师讲PHP函数的实现原理及性能分析(二)
2015/05/13 PHP
javascript EXCEL 操作类代码
2009/07/30 Javascript
JavaScript中实现块作用域的方法
2010/04/01 Javascript
基于jquery的滚动鼠标放大缩小图片效果
2011/10/27 Javascript
Ubuntu 11.10 安装Node.js的方法
2011/11/30 Javascript
仿淘宝TAB切换搜索框搜索切换的相关内容
2014/09/21 Javascript
浏览器中url存储的JavaScript实现
2015/07/07 Javascript
JavaScript+html5 canvas绘制的小人效果
2016/01/27 Javascript
JavaScript function函数种类详解
2016/02/22 Javascript
Angular.JS学习之依赖注入$injector详析
2016/10/20 Javascript
Angular页面间切换及传值的4种方法
2016/11/04 Javascript
浅谈html转义及防止javascript注入攻击的方法
2016/12/04 Javascript
js实现微博发布小功能
2017/01/12 Javascript
JavaScript实现的商品抢购倒计时功能示例
2017/04/17 Javascript
SpringMVC简单整合Angular2的示例
2017/07/31 Javascript
nodejs的安装使用与npm的介绍
2019/09/11 NodeJs
Openlayers显示地理位置坐标的方法
2020/09/28 Javascript
python进程管理工具supervisor使用实例
2014/09/17 Python
Python re模块介绍
2014/11/30 Python
Python比较2个时间大小的实现方法
2018/04/10 Python
python使用socket创建tcp服务器和客户端
2018/04/12 Python
python实现人民币大写转换
2018/06/20 Python
python reverse反转部分数组的实例
2018/12/13 Python
python远程调用rpc模块xmlrpclib的方法
2019/01/11 Python
Python 3.8中实现functools.cached_property功能
2019/05/29 Python
python脚本当作Linux中的服务启动实现方法
2019/06/28 Python
python matplotlib如何给图中的点加标签
2019/11/14 Python
python 用 xlwings 库 生成图表的操作方法
2019/12/22 Python
Python log模块logging记录打印用法解析
2020/01/20 Python
通过实例解析Python RPC实现原理及方法
2020/07/07 Python
市场专员岗位职责
2014/02/14 职场文书
厨房管理计划书
2014/04/27 职场文书
大学生活动总结模板
2014/07/02 职场文书
2014年秘书工作总结
2014/11/25 职场文书
MySQL中VARCHAR与CHAR格式数据的区别
2021/05/26 MySQL
python实现一个简单的贪吃蛇游戏附代码
2022/06/28 Python