# 服務提供者 - [簡介](#introduction) - [編寫服務提供者](#writing-service-providers) - [注冊方法](#the-register-method) - [啟動方法](#the-boot-method) - [注冊提供者](#registering-providers) - [延遲提供者](#deferred-providers) <a name="introduction"></a> ## 簡介 服務提供者是所有 Laravel 應用程序啟動的中心所在。包括你自己的應用程序，以及所有的 Laravel 核心服務，都是通過服務提供者啟動的。 但我們所說的「啟動」指的是什么？一般而言，我們指的是 **注冊** 事物，包括注冊服務容器綁定、事件偵聽器、中間件，甚至路由。服務提供者是設置你的應用程序的中心所在。 若你打開 Laravel 的 `config/app.php` 文件，你將會看到 `providers` 數組。這些是你的應用會加載的所有服務提供者類。當然，它們之中有很多屬于「延遲」提供者，意味著這些提供者不會在每次請求中都加載，而只有在真正需要這些提供者提供的服務時他們才會被加載。 在這份概述中，你會學到如何編寫你自己的服務提供者，并將它們注冊于你的 Laravel 應用程序。 <a name="writing-service-providers"></a> ## 編寫服務提供者 所有的服務提供者都繼承了 `Illuminate\Support\ServiceProvider` 類。大多數服務提供者包含一個 `register` 方法和一個 `boot` 方法，在 `register` 方法中，你應該 **只將事物綁定至 [服務容器](/docs/{{version}}/container) 之中**。永遠不要試圖在 `register` 方法中注冊任何事件偵聽器、路由或任何其它功能。 Artisan 命令行接口可以很容易地通過 `make:provider` 命令生成新的提供者： php artisan make:provider RiakServiceProvider <a name="the-register-method"></a> ### 注冊方法 如同之前提到的，在 `register` 方法中，你應該只將事物綁定至 [服務容器](/docs/{{version}}/container) 中。永遠不要嘗試在 `register` 方法中注冊任何事件偵聽器、路由或任何其它功能。否則的話，你可能會意外地使用到由尚未加載的服務提供者所提供的服務。 現在，讓我們來看看基本的服務提供者。在你的任意一個服務提供者方法中，你總是可以通過訪問 `$app` 屬性使用服務容器。 <?php namespace App\Providers; use Riak\Connection; use Illuminate\Support\ServiceProvider; class RiakServiceProvider extends ServiceProvider { /** * 在容器中注冊綁定。 * * @return void */ public function register() { $this->app->singleton(Connection::class, function ($app) { return new Connection(config('riak')); }); } } 此服務提供者只定義了一個 `register` 方法，并在服務容器中使用此方法定義了一份 `Riak\Contracts\Connection` 的實現。若你不了解服務容器是如何運作的，可查閱[其文檔](/docs/{{version}}/container)。 <a name="the-boot-method"></a> ### 啟動方法 因此，若我們需要在我們的服務提供者中注冊一個視圖 composer 則應該在 `boot` 方法中完成。**此方法會在所有其它的服務提供者被注冊后才被調用**，意味著你能訪問已經被框架注冊的所有其它服務： <?php namespace App\Providers; use Illuminate\Support\ServiceProvider; class ComposerServiceProvider extends ServiceProvider { /** * 啟動任意應用服務。 * * @return void */ public function boot() { view()->composer('view', function () { // }); } } #### 啟動方法依賴注入 我們可以為我們 `boot` 方法中的依賴作類型提示。[服務容器](/docs/{{version}}/container) 會自動注入你所需要的任何依賴： use Illuminate\Contracts\Routing\ResponseFactory; public function boot(ResponseFactory $response) { $response->macro('caps', function ($value) { // }); } <a name="registering-providers"></a> ## 注冊提供者 所有的服務提供者都在 `config/app.php` 配置文件中被注冊。這個文件包含了一個 `providers` 數組，你可以在其中列出你所有服務提供者的類名。此數組默認會列出一組 Laravel 的核心服務提供者。這些提供者啟動 Laravel 的核心組件，如郵件寄送者、隊列、緩存等。 將你的提供者加入此數組來注冊服務提供者： 'providers' => [ // 其它的服務提供者 App\Providers\ComposerServiceProvider::class, ], <a name="deferred-providers"></a> ## 延遲提供者 若你的提供者 **僅** 在 [服務容器](/docs/{{version}}/container) 中注冊綁定，你可以選擇推遲執行其注冊邏輯，直到其注冊的綁定真正被需要的時候才執行，延遲提供者加載可提高應用程序的性能，因為它不會在每個請求中都從文件系統加載。 Laravel 編譯并保存了一份清單，包括由延緩服務提供者所提供的所有服務，以及其服務提供者類的類名。因此，只有在當你在試圖解析其中的服務時，Laravel 才會加載該服務提供者。 要延遲加載提供者，可將 `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(Connection::class, function ($app) { return new Connection($app['config']['riak']); }); } /** * 獲取提供者所提供的服務。 * * @return array */ public function provides() { return [Connection::class]; } } ## 譯者署名 | 用戶名 | 頭像 | 職能 | 簽名 | |---|---|---|---| | [@rang9527](https://github.com/rang9527) | <img class="avatar-66 rm-style" src="https://avatars2.githubusercontent.com/u/10138783?v=3&s=132"> | 翻譯 | 進城務工人員，[@rang9527](https://github.com/rang9527/) at Github |