Laravel5中contracts详解

   2015-07-22 0
核心提示:在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接口还能看作一个简洁的文档便于阅读。

 
标签: Laravel5 contracts
反对 0举报 0 评论 0
 

免责声明:本文仅代表作者个人观点,与乐学笔记(本网)无关。其原创性以及文中陈述文字和内容未经本站证实,对本文以及其中全部或者部分内容、文字的真实性、完整性、及时性本站不作任何保证或承诺,请读者仅作参考,并请自行核实相关内容。
    本网站有部分内容均转载自其它媒体,转载目的在于传递更多信息,并不代表本网赞同其观点和对其真实性负责,若因作品内容、知识产权、版权和其他问题,请及时提供相关证明等材料并与我们留言联系,本网站将在规定时间内给予删除等相关处理.

  • 1. Laravel 5.1-5.3 所使用的代码编写规范 - La
    从Laravel5.1开始采用了psr-2代码风格规范, 比如在Laravel5.1以前的版本中,我们看见的Laravel代码风格是这样的:?php namespace App\Http\Controllers\Auth;use App\User;use Validator;use App\Http\Controllers\Controller;use Illuminate\Foundation\Auth\
    12-06 Laravel
  • Php Laravel5 学习笔记(二)
    视频教程网址数据库操作make:migration 可以生成数据库迁移文件 Eloquent 可以直接命令行操作数据库数据数据库字段处理Model中$dates属性可以将字段转换为 Carbon 对象 setXXXAttribute 方法可以对参数做预处理 XXX为字段名 scopeXXX 方法可以对查询做统一处
    09-12 Laravel
  • Laravel5搭建Homestead开发环境
    $ vagrant box add laravel/homestead若遇到网速问题,可以单独下载laravel-x.x.x.box文件,然后来执行$ vagrant box add laravel/homestead laravel-x.x.x.box检查是否安装成功$ vagrant box list配置Homestead下载Homestead跟vagrant相关的配置,就在larave
  • Php Laravel5 学习笔记(一)
    视频教程网址环境安装安装教程基础命令composer create-project laravel/laravel Larvavel5创建工程php artisan key:generate生成 AppKeyphp -S localhost:8888 -t public自己启动服务器php artisan serve用内建部分启动服务器php artisan make:controller 控
  • Laravel5.0发布新版本特性详解
    这篇文章主要介绍了Laravel 5.0 发布 新版本特性详解,本文讲解了目录结构、Contracts、路由缓存、路由中间、控制器方法注入、认证脚手架等新特性,需要的朋友可以参考下
  • 初识laravel5
    laravel5发布了,目前国内相关资料还比较少,只能先翻墙去官网先看看了,初步总结了一些变化,就想写下来。
    07-22 laravel5
  • laravel5实现模板主题功能
    很多cms里都有模板主题功能,我们可以通过一个配置切换主题,这个功能在laravel下如何实现呢?今天我们就来探讨下这个问题。
  • laravel5实现模板主题功能(续)
    前面一篇文章,我们简单讨论了laravel模板主题功能,本文我们继续探讨laravel模板主题功能的实现,本次实现比较重,有兴趣慢慢看吧。
  • Laravel5学习笔记
    本文记录的是个人在学习实用laravel5的过程中遇到的几个重点的地方,也是最容易犯错的地方,这里记录下来,分享给大家。
  • Laravel5框架学习之Laravel入门和新建项目
    这篇文章主要是Laravel5框架学习系列的第一篇文章,跟其他开篇文章一样,我们来学习下Laravel入门和新建项目,十分的简单易懂,有需要的小伙伴可以参考下。
点击排行