服務提供者 · laravel 5.4

<article><h1>服務提供者</h1><ul><li><a href="#introduction">簡介</a></li><li><a href="#writing-service-providers">編寫服務提供者</a><ul><li><a href="#the-register-method">注冊方法</a></li><li><a href="#the-boot-method">引導方法</a></li></ul></li><li><a href="#registering-providers">注冊提供者</a></li><li><a href="#deferred-providers">延遲的提供者</a></li></ul><a name="introduction"></a><h2><a href="#introduction">簡介</a></h2>服務提供者是所有 Laravel 應用程序引導啟動的中心所在。包括您自己的應用程序，以及所有的 Laravel 核心服務，都是通過服務提供者引導啟動的。但我們所謂的「引導啟動」指的是什么？一般而言，我們指的是注冊事務，包括注冊服務容器綁定，事件監聽器，中間件，甚至路由。服務提供者是配置應用程序的中心所在。如果您打開 Laravel 的 <code class=" language-php">config/app.php</code> 文件，您會看到一個 <code class=" language-php">providers</code> 數組。這些是將被應用程序加載的服務提供者類。當然，它們其中有許多是「延遲」提供者，意味著它們不會每次請求都加載，只會按需加載。在本概述中，您將學習如何編寫自己的服務提供商，并在您的 Laravel 應用程序中注冊它們。<a name="writing-service-providers"></a><h2><a href="#writing-service-providers">編寫服務提供者</a></h2>所有服務提供者都需要繼承 <code class=" language-php">Illuminate\Support\ServiceProvider</code> 類。大多數服務提供者都包含 <code class=" language-php">register</code> 和 <code class=" language-php">boot</code> 方法。在 <code class=" language-php">register</code> 方法中，您應該只能將事務綁定到 <a href="/docs/5.4/container">服務容器</a>。不應該在 <code class=" language-php">register</code> 方法中嘗試注冊任何事件監聽器，路由或者任何其他功能。Artisan 命令行可以生成一個新的提供者通過 <code class=" language-php">make:provider</code> 命令：<pre class=" language-php"><code class=" language-php">php artisan make:provider RiakServiceProvider</code></pre><a name="the-register-method"></a><h3>注冊方法</h3>如前所述，在 <code class=" language-php">register</code> 方法中，您只能將事務綁定到 <a href="/docs/5.4/container">服務容器</a> 。不應該在 <code class=" language-php">register</code> 方法中嘗試注冊任何事件監聽器，路由或者任何其他功能。否則，您可能會意外的使用到尚未加載的服務提供者提供的服務。讓我們來看看一個基本的服務提供者。在服務提供者的方法中，都會提供一個有服務容器訪問權限的 <code class=" language-php">$app</code> 屬性：現在，讓我們來看看基本的服務提供者。在你的任意一個服務提供者方法中，你總是可以通過訪問 <code class=" language-php">$app</code> 屬性使用服務容器：<pre class=" language-php"><code class=" language-php"><?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')); }); } }</code></pre>服務提供者只定義了一個 <code class=" language-php">register</code> 方法，并且使用該方法在服務容器中定義了一個 <code class=" language-php">Riak\Connection</code> 類的實現。如果您不明白服務容器的工作原理，請查看 <a href="/docs/5.4/container">服務容器</a>。<a name="the-boot-method"></a><h3>引導方法</h3>那么，如果我們需要在我們的服務提供商中注冊一個視圖合成器呢？這應該在 <code class=" language-php">boot</code> 方法中完成。此方法在所有其他服務提供者均已注冊之后調用，這意味著您可以訪問已由框架注冊的所有服務：<pre class=" language-php"><code class=" language-php"><?php namespace App\Providers; use Illuminate\Support\ServiceProvider; class ComposerServiceProvider extends ServiceProvider { /** * 引導啟動任何應用程序服務 * * @return void */ public function boot() { view()->composer('view', function () { // }); } }</code></pre><h4>引導方法依賴注入</h4>您可以為服務提供者的 <code class=" language-php">boot</code> 方法設置類型提示。<a href="/docs/5.4/container">服務容器</a> 會自動注入您需要的任何依賴：<pre class=" language-php"><code class=" language-php">use Illuminate\Contracts\Routing\ResponseFactory; public function boot(ResponseFactory $response) { $response->macro('caps', function ($value) { // }); }</code></pre><a name="registering-providers"></a><h2><a href="#registering-providers">注冊提供者</a></h2>所有服務提供者都在 <code class=" language-php">config/app.php</code> 配置文件中注冊。此文件包含一個服務提供者類數組 <code class=" language-php">providers</code> 。默認情況下，它只會列出 Laravel 核心服務提供者類。這些服務提供者引導啟動 Laravel 核心組件，例如郵件程序，隊列，緩存和其他。要注冊您的提供程序，只需將其添加到數組：<pre class=" language-php"><code class=" language-php">'providers' => [ // Other Service Providers App\Providers\ComposerServiceProvider::class, ],</code></pre><a name="deferred-providers"></a><h2><a href="#deferred-providers">延遲的提供者</a></h2>如果您的提供程序 僅 在 <a href="/docs/5.4/container">服務容器</a> 中注冊綁定，您可以選擇推遲其注冊，直到真正需要注冊綁定時。延遲加載服務提供者將提高應用程序的性能，因為它不會每次都從文件系統中加載。Laravel 編譯并保存了一份清單，包括由延緩服務提供者所提供的所有服務，以及其服務提供者類的類名。因此，只有在當您在試圖解析其中的服務時，Laravel 才會加載該服務提供者。若要推遲提供者的加載，請將 <code class=" language-php">defer</code> 屬性設置為 <code class=" language-php">true</code> ，并定義 <code class=" language-php">provides</code> 方法。<code class=" language-php">provides</code> 應該返回由提供者注冊的服務容器綁定：<pre class=" language-php"><code class=" language-php"><?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]; } }</code></pre><h2>譯者署名</h2><table><thead><tr><th>用戶名</th><th>頭像</th><th>職能</th><th>簽名</th></tr></thead><tbody><tr><td><a href="https://github.com/e421083458">@e421083458</a></td><td><img class="avatar-66 rm-style" src="https://dn-phphub.qbox.me/uploads/avatars/10802_1486368142.jpeg?imageView2/1/w/100/h/100"></td><td>翻譯</td><td>Github求star，<a href="https://github.com/e421083458/">@e421083458</a> at Github</td></tr></tbody></table></article>