Laravel 核心--服務(wù)容器

簡(jiǎn)介

服務(wù)容器就是一個(gè)普通的容器点寥,用來封裝類的實(shí)例,然后在需要的時(shí)候再取出來。用更專業(yè)的術(shù)語來說是服務(wù)容器實(shí)現(xiàn)了控制反轉(zhuǎn)(Inversion of Control,縮寫為IoC)贮配,
意思是正常情況下類A需要一個(gè)類B的時(shí)候,我們需要自己去new類B塞赂,意味著我們必須知道類B的更多細(xì)節(jié),比如構(gòu)造函數(shù)昼蛀,隨著項(xiàng)目的復(fù)雜性增大宴猾,這種依賴是毀滅性的〉鹦控制反轉(zhuǎn)的意思就是仇哆,將類A主動(dòng)獲取類B的過程顛倒過來變成被動(dòng),類A只需要聲明它需要什么夫植,然后由容器提供讹剔。

想象一下

樣做的好處是油讯,類A不依賴于類B的實(shí)現(xiàn),這樣在一定程度上解決了耦合問題延欠。

在Laravel的服務(wù)容器中陌兑,為了實(shí)現(xiàn)控制反轉(zhuǎn),可以有以下兩種:

  1. 依賴注入(Dependency Injection)由捎。
  2. 綁定兔综。

依賴注入

依賴注入是一種類型提示,舉官網(wǎng)的例子

<?php

namespace App\Http\Controllers;

use App\User;
use App\Repositories\UserRepository;
use App\Http\Controllers\Controller;

class UserController extends Controller
{
    /**
     * 用于獲取用戶數(shù)據(jù)
     *
     * @var UserRepository
     */
    protected $users;

    /**
     * 構(gòu)造方法狞玛,聲明所需要的類型
     * 
     * @param  UserRepository  $users
     * @return void
     */
    public function __construct(UserRepository $users)
    {
        $this->users = $users;
    }

    /**
     * Show the profile for the given user.
     *
     * @param  int  $id
     * @return Response
     */
    public function show($id)
    {
        $user = $this->users->find($id);
        return view('user.profile', ['user' => $user]);
    }
}

在本例中软驰,UserController 需要從數(shù)據(jù)源獲取用戶,所以心肪,我們注入了一個(gè)可以獲取用戶的服務(wù) UserRepository锭亏,其扮演的角色類似使用 Eloquent 從數(shù)據(jù)庫獲取用戶信息。
這里UserController需要一個(gè)UserRepository實(shí)例硬鞍,我們只需在構(gòu)造方法中聲明我們需要的類型慧瘤,容器在實(shí)例化UserController時(shí)會(huì)自動(dòng)生成UserRepository的實(shí)例(或者實(shí)現(xiàn)類,因?yàn)?code>UserRepository可以為接口)膳凝,而不用主動(dòng)去獲取UserRepository的實(shí)例碑隆,這樣也就避免了了解UserRepository的更多細(xì)節(jié),也不用解決UserRepository所產(chǎn)生的依賴蹬音,我們所做的僅僅是聲明我們所需要的類型上煤,所有的依賴問題都交給容器去解決。

綁定

幾乎所有的服務(wù)容器綁定都是在服務(wù)提供者中完成著淆。

注:如果一個(gè)類沒有基于任何接口那么就沒有必要將其綁定到容器劫狠。容器并不需要被告知如何構(gòu)建對(duì)象,因?yàn)樗鼤?huì)使用 PHP 的反射服務(wù)自動(dòng)解析出具體的對(duì)象永部。

綁定操作一般在 服務(wù)提供者 ServiceProviders中的register方法中独泞,最基本的綁定是容器的bind方法,它接受一個(gè)類的別名或者全名和一個(gè)閉包來獲取實(shí)例:

簡(jiǎn)單的綁定

在一個(gè)服務(wù)提供者中苔埋,可以通過 $this->app 變量訪問容器懦砂,然后使用 bind 方法注冊(cè)一個(gè)綁定,該方法需要兩個(gè)參數(shù)组橄,第一個(gè)參數(shù)是我們想要注冊(cè)的類名或接口名稱荞膘,第二個(gè)參數(shù)是返回類的實(shí)例的閉包:

$this->app->bind('blogConfig', function ($app) {
    return new MapRepository();
});
$this->app->bind('HelpSpot\API', function ($app) {
    return new HelpSpot\API($app->make('HttpClient'));
});

綁定一個(gè)單例

singleton方法和bind寫法沒什么區(qū)別,singleton方法綁定一個(gè)只需要解析一次的類或接口到容器,然后接下來對(duì)容器的調(diào)用將會(huì)返回同一個(gè)實(shí)例:

$this->app->singleton('HelpSpot\API', function ($app) {
    return new HelpSpot\API($app->make('HttpClient'));
});

綁定實(shí)例

你還可以使用 instance 方法綁定一個(gè)已存在的對(duì)象實(shí)例到容器,隨后調(diào)用容器將總是返回給定的實(shí)例:

$api = new HelpSpot\API(new HttpClient);
$this->app->instance('HelpSpot\Api', $api);

上文中提到的request實(shí)例就是通過這種方法綁定到容器的:

    $this->app->instance('request', $request);

綁定原始值

你可能有一個(gè)接收注入類的類玉工,同時(shí)需要注入一個(gè)原生的數(shù)值比如整型羽资,可以結(jié)合上下文輕松注入這個(gè)類需要的任何值:

$this->app->when('App\Http\Controllers\UserController')
    ->needs('$variableName')
    ->give($value);

綁定接口到實(shí)現(xiàn)

服務(wù)容器的一個(gè)非常強(qiáng)大的功能是其綁定接口到實(shí)現(xiàn)。我們假設(shè)有一個(gè) EventPusher 接口及其實(shí)現(xiàn)類RedisEventPusher 遵班,編寫完該接口的 RedisEventPusher 實(shí)現(xiàn)后屠升,就可以將其注冊(cè)到服務(wù)容器:

$this->app->bind(
    'App\Contracts\EventPusher', 
    'App\Services\RedisEventPusher'
);

這段代碼告訴容器當(dāng)一個(gè)類需要 EventPusher 的實(shí)現(xiàn)時(shí)將會(huì)注入RedisEventPusher潮改,現(xiàn)在我們可以在構(gòu)造器或者任何其它通過服務(wù)容器注入依賴的地方進(jìn)行 EventPusher 接口的依賴注入:

use App\Contracts\EventPusher;

/**
 * 創(chuàng)建一個(gè)新的類實(shí)例
 *
 * @param  EventPusher  $pusher
 * @return void
 */
public function __construct(EventPusher $pusher){
    $this->pusher = $pusher;
}

上下文綁定

有時(shí)侯我們可能有兩個(gè)類使用同一個(gè)接口,但我們希望在每個(gè)類中注入不同實(shí)現(xiàn)腹暖,例如汇在,兩個(gè)控制器依賴 Illuminate\Contracts\Filesystem\Filesystem
契約 的不同實(shí)現(xiàn)。Laravel 為此定義了簡(jiǎn)單微服、平滑的接口:

use Illuminate\Support\Facades\Storage;
use App\Http\Controllers\VideoController;
use App\Http\Controllers\PhotoControllers;
use Illuminate\Contracts\Filesystem\Filesystem;

$this->app->when(PhotoController::class)
    ->needs(Filesystem::class)
    ->give(function () {
        return Storage::disk('local');
    });

$this->app->when(VideoController::class)
    ->needs(Filesystem::class)
    ->give(function () {
        return Storage::disk('s3');
    });

標(biāo)簽

少數(shù)情況下趾疚,我們需要解析特定分類下的所有綁定,例如以蕴,你正在構(gòu)建一個(gè)接收多個(gè)不同 Report 接口實(shí)現(xiàn)的報(bào)告聚合器糙麦,在注冊(cè)完 Report實(shí)現(xiàn)之后,可以通過 tag 方法給它們分配一個(gè)標(biāo)簽:

$this->app->bind('SpeedReport', function () {
    //
});

$this->app->bind('MemoryReport', function () {
    //
});

$this->app->tag(['SpeedReport', 'MemoryReport'], 'reports');

這些服務(wù)被打上標(biāo)簽后丛肮,可以通過 tagged 方法來輕松解析它們:

$this->app->bind('ReportAggregator', function ($app) {
    return new ReportAggregator($app->tagged('reports'));
});

解析

也就是獲取綁定的實(shí)例:

獲取方法

1.  app('HelpSpot\API');

2.  app()->make('HelpSpot\API');

3.  app()['HelpSpot\API'];

4.  resolve('HelpSpot\API');

以上四種方法均會(huì)返回獲得HelpSpot\API的實(shí)例赡磅。
區(qū)別是在一次請(qǐng)求的生命周期中:
bind方法的閉包會(huì)在每一次調(diào)用以上四種方法時(shí)執(zhí)行,
singleton方法的閉包只會(huì)執(zhí)行一次宝与。

在使用中焚廊,如果每一個(gè)類要獲的不同的實(shí)例,或者需要“個(gè)性化”的實(shí)例時(shí)习劫,這時(shí)我們需要用bind方法以免這次的使用對(duì)下次的使用造成影響咆瘟;

如果實(shí)例化一個(gè)類比較耗時(shí)或者類的方法不依賴該生成的上下文,那么我們可以使用singleton方法綁定诽里。singleton方法綁定的好處就是袒餐,如果在一次請(qǐng)求中我們多次使用某個(gè)類,那么只生成該類的一個(gè)實(shí)例將節(jié)省時(shí)間和空間谤狡。

自動(dòng)注入

最后灸眼,也是最常用的,你可以簡(jiǎn)單的通過在類的構(gòu)造函數(shù)中對(duì)依賴進(jìn)行類型提示來從容器中解析對(duì)象墓懂,控制器焰宣、事件監(jiān)聽器隊(duì)列任務(wù)捕仔、中間件等都是通過這種方式匕积。在實(shí)踐中,這是大多數(shù)對(duì)象從容器中解析的方式榜跌。
容器會(huì)自動(dòng)為其解析類注入依賴闸天,例如,你可以在控制器的構(gòu)造函數(shù)中為應(yīng)用定義的倉庫進(jìn)行類型提示斜做,該倉庫會(huì)自動(dòng)解析并注入該類:

<?php

namespace App\Http\Controllers;

use App\Users\Repository as UserRepository;

class UserController extends Controller{
    /**
     * 用戶倉庫實(shí)例
     */
    protected $users;

    /**
     * 創(chuàng)建一個(gè)控制器實(shí)例
     *
     * @param  UserRepository  $users
     * @return void
     */
    public function __construct(UserRepository $users)
    {
        $this->users = $users;
    }

    /**
     * 通過指定ID顯示用戶
     *
     * @param  int  $id
     * @return Response
     */
    public function show($id)
    {
        //
    }
}

容器事件

服務(wù)容器在每一次解析對(duì)象時(shí)都會(huì)觸發(fā)一個(gè)事件,可以使用 resolving 方法監(jiān)聽該事件:

$this->app->resolving(function ($object, $app) {
    // Called when container resolves object of any type...
});

$this->app->resolving(HelpSpot\API::class, function ($api, $app) {
    // Called when container resolves objects of type "HelpSpot\API"...
});

正如你所看到的湾揽,被解析的對(duì)象將會(huì)傳遞給回調(diào)函數(shù)瓤逼,從而允許你在對(duì)象被傳遞給消費(fèi)者之前為其設(shè)置額外屬性笼吟。

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市霸旗,隨后出現(xiàn)的幾起案子贷帮,更是在濱河造成了極大的恐慌,老刑警劉巖诱告,帶你破解...
    沈念sama閱讀 206,378評(píng)論 6 481
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件撵枢,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡精居,警方通過查閱死者的電腦和手機(jī)锄禽,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 88,356評(píng)論 2 382
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來靴姿,“玉大人沃但,你說我怎么就攤上這事》鹣牛” “怎么了宵晚?”我有些...
    開封第一講書人閱讀 152,702評(píng)論 0 342
  • 文/不壞的土叔 我叫張陵,是天一觀的道長维雇。 經(jīng)常有香客問我淤刃,道長,這世上最難降的妖魔是什么吱型? 我笑而不...
    開封第一講書人閱讀 55,259評(píng)論 1 279
  • 正文 為了忘掉前任逸贾,我火速辦了婚禮,結(jié)果婚禮上唁影,老公的妹妹穿的比我還像新娘耕陷。我一直安慰自己,他們只是感情好据沈,可當(dāng)我...
    茶點(diǎn)故事閱讀 64,263評(píng)論 5 371
  • 文/花漫 我一把揭開白布哟沫。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪灯节。 梳的紋絲不亂的頭發(fā)上屈暗,一...
    開封第一講書人閱讀 49,036評(píng)論 1 285
  • 那天,我揣著相機(jī)與錄音隆敢,去河邊找鬼。 笑死崔慧,一個(gè)胖子當(dāng)著我的面吹牛拂蝎,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播惶室,決...
    沈念sama閱讀 38,349評(píng)論 3 400
  • 文/蒼蘭香墨 我猛地睜開眼温自,長吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼玄货!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起悼泌,我...
    開封第一講書人閱讀 36,979評(píng)論 0 259
  • 序言:老撾萬榮一對(duì)情侶失蹤松捉,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后馆里,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體隘世,經(jīng)...
    沈念sama閱讀 43,469評(píng)論 1 300
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 35,938評(píng)論 2 323
  • 正文 我和宋清朗相戀三年鸠踪,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了丙者。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 38,059評(píng)論 1 333
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡慢哈,死狀恐怖蔓钟,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情卵贱,我是刑警寧澤滥沫,帶...
    沈念sama閱讀 33,703評(píng)論 4 323
  • 正文 年R本政府宣布,位于F島的核電站键俱,受9級(jí)特大地震影響兰绣,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜编振,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 39,257評(píng)論 3 307
  • 文/蒙蒙 一缀辩、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧踪央,春花似錦臀玄、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,262評(píng)論 0 19
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至液斜,卻和暖如春累贤,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背少漆。 一陣腳步聲響...
    開封第一講書人閱讀 31,485評(píng)論 1 262
  • 我被黑心中介騙來泰國打工臼膏, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人示损。 一個(gè)月前我還...
    沈念sama閱讀 45,501評(píng)論 2 354
  • 正文 我出身青樓渗磅,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子始鱼,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 42,792評(píng)論 2 345

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理论巍,服務(wù)發(fā)現(xiàn),斷路器风响,智...
    卡卡羅2017閱讀 134,599評(píng)論 18 139
  • 從三月份找實(shí)習(xí)到現(xiàn)在,面了一些公司丹禀,掛了不少状勤,但最終還是拿到小米、百度双泪、阿里持搜、京東、新浪焙矛、CVTE葫盼、樂視家的研發(fā)崗...
    時(shí)芥藍(lán)閱讀 42,184評(píng)論 11 349
  • 1. Java基礎(chǔ)部分 基礎(chǔ)部分的順序:基本語法,類相關(guān)的語法村斟,內(nèi)部類的語法贫导,繼承相關(guān)的語法,異常的語法蟆盹,線程的語...
    子非魚_t_閱讀 31,581評(píng)論 18 399
  • 開學(xué)第一課在9月1日晚上 9:00 準(zhǔn)時(shí)播出孩灯,本次活動(dòng)主題是《中華驕傲》,主持人董卿和撒貝寧逾滥,閃亮登場(chǎng)峰档。主持人說:...
    好逗逼閱讀 150評(píng)論 0 1
  • 請(qǐng)想象一下你與深愛的人正躺在床上。你們相擁而臥寨昙,感覺安心讥巡、溫暖、充滿活力又無比的自信舔哪。恰當(dāng)?shù)臅r(shí)間恰當(dāng)?shù)牡攸c(diǎn)欢顷,身邊是...
    嬌之語閱讀 1,049評(píng)論 0 1