Laravel 5 Chinese Document

服務提供者

簡介

服務提供者是所有 Laravel 應用程式的啟動中心。你的應用程式,以及所有 Laravel 的核心服務,都是透過服務提供者啟動。

但我們所說的「啟動」指的是什麼?一般而言,我們指註冊事物,包括註冊服務容器綁定、事件監聽器、過濾器,甚至路由。服務提供者是你的應用程式設定中心所在。

如果你開啟包含於 Laravel 中 config/app.php 此一檔案,你會看到 providers 陣列。這些是所有將載入至你的應用程式裡的服務提供者類別。當然,它們之中有很多屬於「緩載」提供者,意思是除非真正需要它們所提供的服務,否則它們並不會在每一個請求中都被載入。

在這份概述中,你會學到如何編寫你自己的服務提供者,並將它們註冊於你的 Laravel 應用程式。

基本提供者範例

所有的服務提供者都應繼承 Illuminate\Support\ServiceProvider 此一類別。在這個抽象類別中,至少必須定義一個方法: register 。在 register 方法中,應該只綁定服務到服務容器之中。你永遠不該試圖在 register 方法中註冊任何事件監聽器、路由或任何其他功能。

Artisan 命令行介面可以很容易地透過 make:provider 產生新的提供者:

php artisan make:provider RiakServiceProvider

註冊者方法

現在,讓我們來看看基本的服務提供者:

<?php namespace App\Providers;

use Riak\Connection;
use Illuminate\Support\ServiceProvider;

class RiakServiceProvider extends ServiceProvider {

    /**
     * 在容器中註冊綁定。
     *
     * @return void
     */
    public function register()
    {
        $this->app->singleton('Riak\Contracts\Connection', function($app)
        {
            return new Connection($app['config']['riak']);
        });
    }

}

這個服務提供者只定義了一個 register 方法,並在服務容器中使用此方法定義了一份 Riak\Contracts\Connection 的實作。若你還不瞭解服務容器是如何運作的,不用擔心,我們很快會提到它

此類別位於 App\Providers 命名空間之下,因為這是 Laravel 中預設服務提供者所在的位置。然而,你可以隨自己的需要改變它。你的服務提供者可被置於任何 Composer 能自動載入的位置。

啟動方法

所以,若我們需要在服務提供者中註冊一個事件監聽器,該怎麼做?它應該在 boot 方法中完成。這個方法會在所有的服務提供者註冊後才被呼叫,這讓你能取用框架中所有其他已註冊過的服務。

<?php namespace App\Providers;

use Event;
use Illuminate\Support\ServiceProvider;

class EventServiceProvider extends ServiceProvider {

    /**
     * 執行註冊後的啟動服務。
     *
     * @return void
     */
    public function boot()
    {
        Event::listen('SomeEvent', 'SomeEventHandler');
    }

    /**
     * 在容器中註冊綁定。
     *
     * @return void
     */
    public function register()
    {
        //
    }

}

我們可以對 boot 方法中的相依作型別暗示。服務容器會自動注入任何你所需要的相依:

use Illuminate\Contracts\Events\Dispatcher;

public function boot(Dispatcher $events)
{
    $events->listen('SomeEvent', 'SomeEventHandler');
}

註冊提供者

所有的服務提供者都在 config/app.php 此一設定檔中被註冊。此檔包含了一個 providers 陣列,你可以在其中列出你所有服務提供者的名稱。此陣列預設會列出一組 Laravel 的核心服務提供者。這些提供者啟動了 Laravel 的核心元件,例如郵件寄送者、隊列、快取及其他等等。

要註冊你的提供者,只要把它加入此陣列:

'providers' => [
    // 其他的服務提供者

    'App\Providers\AppServiceProvider',
],

緩載提供者

若你的提供者僅僅用於綁定註冊到服務容器,你可以選擇延緩其註冊,直到真正需要其中註冊的綁定才載入。延緩像這樣的提供者載入可增進應用程式的效能,因為這樣就不用每個請求都從檔案系統中將其載入。

要延緩提供者載入,將 defer 性質設為 true,並定義一個 provides 方法。 provides 方法應回傳提供者所註冊的服務容器綁定。

<?php namespace App\Providers;

use Riak\Connection;
use Illuminate\Support\ServiceProvider;

class RiakServiceProvider extends ServiceProvider {

    /**
     * 指定是否延緩提供者載入。
     *
     * @var bool
     */
    protected $defer = true;

    /**
     * 註冊服務提供者。
     *
     * @return void
     */
    public function register()
    {
        $this->app->singleton('Riak\Contracts\Connection', function($app)
        {
            return new Connection($app['config']['riak']);
        });
    }

    /**
     * 取得提供者所提供的服務。
     *
     * @return array
     */
    public function provides()
    {
        return ['Riak\Contracts\Connection'];
    }

}

Laravel 編譯並儲存所有由延緩服務提供者所提供的服務清單,以及其服務提供者的類別名稱。只有在當你企圖解析其中的服務時, Laravel 才會載入服務提供者。