萬盛學電腦網

 萬盛學電腦網 >> 網絡編程 >> php編程 >> Laravel5中contracts詳解

Laravel5中contracts詳解

 在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接口列表:

 

代碼如下:
IlluminateContractsAuthGuard
IlluminateContractsAuthPasswordBroker
IlluminateContractsBusDispatcher
IlluminateContractsCacheRepository
IlluminateContractsCacheFactory
IlluminateContractsConfigRepository
IlluminateContractsContainerContainer
IlluminateContractsCookieFactory
IlluminateContractsCookieQueueingFactory
IlluminateContractsEncryptionEncrypter
IlluminateContractsRoutingRegistrar

 

…… 太多了,懶得繼續貼了,官網手冊裡有。我們就拿 IlluminateContractsRoutingRegistrar 這個contract來演示一下吧。
首先,打開 app/Providers/AppServiceProvider.php,注意register方法:

 

代碼如下:
public function register()
{
$this->app->bind(
'IlluminateContractsAuthRegistrar',
'AppServicesRegistrar'
);
}

 

$this->app 就是Application對象,也是容器對象,通過 $this->app->bind 方法我們綁定了一個實現IlluminateContractsAuthRegistrar接口的類AppServicesRegistrar。

注意,IlluminateContractsAuthRegistrar就是一個contract。AppServicesRegistrar 這個類文件在 app/Services/Registrar.php。

接著我們看 AppHttpControllersAuthAuthController 這個控制器類,看到它有 __construct 構造函數:

 

代碼如下:
public function __construct(Guard $auth, Registrar $registrar)
{
$this->auth = $auth;
$this->registrar = $registrar;

 

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

 

它有兩個參數,對應的類命名空間在腳本開頭可以看到:

 

代碼如下:
use IlluminateContractsAuthGuard;
use IlluminateContractsAuthRegistrar;

 

這兩個都是contract,但我們這裡就拿 Registrar 說,我們注意到這裡面只是通過參數類型指明了$registrar的接口類型,而實際調用的時候實際上是 AppServicesRegistrar 這個類,這就是依賴注入的特性了,Laravel會自動在容器中搜索實現了接口IlluminateContractsAuthRegistrar的類或對象,有的話就取出來作為實際參數傳到構造函數裡。

整個使用流程其實就可以總結為兩個步驟:

向容器中注冊實現contract接口的對象。
構造函數參數類型指定為contract接口類,框架會自動找到符合條件的對象。
那麼再來說說contract的好處。

松耦合

官網給了一個例子解釋什麼是緊耦合以及Contract接口為何能夠松耦合。

先來看看緊耦合的代碼:

 

代碼如下:
<?php namespace AppOrders;
class Repository {
/**
* The cache.
*/
protected $cache;
/**
* Create a new repository instance.
*
* @param SomePackageCacheMemcached $cache
* @return void
*/
public function __construct(SomePackageCacheMemcached $cache)
{
$this->cache = $cache;
}
/**
* Retrieve an Order by ID.
*
* @param int $id
* @return Order
*/
public function find($id)
{
if ($this->cache->has($id))
{
//
}
}
}

 

可以看到構造函數中注入了一個詳細的緩存實現 SomePackageCacheMemcached ,如果換Redis作為緩存服務器或者更改了api方法,就需要修改,而如果項目很大,你不知道還有多少地方需要修改。

那麼,Contract接口是如何解決這個問題的?請看代碼:

 

代碼如下:
<?php namespace AppOrders;
use IlluminateContractsCacheRepository as Cache;
class Repository {
/**
* Create a new repository instance.
*
* @param Cache $cache
* @return void
*/
public function __construct(Cache $cache)
{
$this->cache = $cache;
}
}

 

注意,緩存實現我們使用了一個接口,也就是contract,IlluminateContractsCacheRepository,因為它只是接口,不需要關心背後是memcache還是redis。

簡單性

如果所有服務都使用接口定義,就可以很簡單的決定一個服務需要的功能,更加容易維護和擴展,並且contract接口還能看作一個簡潔的文檔便於閱讀。

copyright © 萬盛學電腦網 all rights reserved