* * * * *
[TOC]
## 簡介
服務提供者是所有 Laravel 應用程序引導啟動的中心所在。包括您自己的應用程序,以及所有的 Laravel 核心服務,都是通過服務提供者引導啟動的。
但我們所謂的「引導啟動」指的是什么?一般而言,我們指的是**注冊**事務,包括注冊服務容器綁定,事件監聽器,中間件,甚至路由。服務提供者是配置應用程序的中心所在。
如果您打開 Laravel 的?`config/app.php`?文件,您會看到一個?`providers`?數組。這些是將被應用程序加載的服務提供者類。當然,它們其中有許多是「延遲」提供者,意味著它們不會每次請求都加載,只會按需加載。
在本概述中,您將學習如何編寫自己的服務提供商,并在您的 Laravel 應用程序中注冊它們。
## 編寫服務提供者
所有服務提供者都需要繼承?`Illuminate\Support\ServiceProvider`?類。大多數服務提供者都包含?`register`?和?`boot`?方法。在?`register`?方法中,您應該**只能將事務綁定到?[服務容器](服務容器.md)**。不應該在?`register`?方法中嘗試注冊任何事件監聽器,路由或者任何其他功能。
Artisan 命令行可以生成一個新的提供者通過?`make:provider`?命令:
~~~
php artisan make:provider RiakServiceProvider
~~~
### 注冊方法
如前所述,在?`register`?方法中,您只能將事務綁定到?[服務容器](服務容器.md)?。不應該在?`register`?方法中嘗試注冊任何事件監聽器,路由或者任何其他功能。否則,您可能會意外的使用到尚未加載的服務提供者提供的服務。
讓我們來看看一個基本的服務提供者。在服務提供者的方法中,都會提供一個有服務容器訪問權限的?`$app`?屬性:
現在,讓我們來看看基本的服務提供者。在你的任意一個服務提供者方法中,你總是可以通過訪問?`$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\Connection`?類的實現。如果您不明白服務容器的工作原理,請查看?[服務容器](服務容器.md)。
### 引導方法
那么,如果我們需要在我們的服務提供商中注冊一個視圖合成器呢?這應該在?`boot`?方法中完成。**此方法在所有其他服務提供者均已注冊之后調用**,這意味著您可以訪問已由框架注冊的所有服務:
~~~
<?php
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
class ComposerServiceProvider extends ServiceProvider
{
/**
* 引導啟動任何應用程序服務
*
* @return void
*/
public function boot()
{
view()->composer('view', function () {
//
});
}
}
~~~
#### 引導方法依賴注入
您可以為服務提供者的?`boot`?方法設置類型提示。[服務容器](服務容器.md)?會自動注入您需要的任何依賴:
~~~
use Illuminate\Contracts\Routing\ResponseFactory;
public function boot(ResponseFactory $response)
{
$response->macro('caps', function ($value) {
//
});
}
~~~
## 注冊提供者
所有服務提供者都在?`config/app.php`?配置文件中注冊。此文件包含一個服務提供者類數組?`providers`?。默認情況下,它只會列出 Laravel 核心服務提供者類。這些服務提供者引導啟動 Laravel 核心組件,例如郵件程序,隊列,緩存和其他。
要注冊您的提供程序,只需將其添加到數組:
~~~
'providers' => [
// Other Service Providers
App\Providers\ComposerServiceProvider::class,
],
~~~
## 延遲的提供者
如果您的提供程序?**僅**?在?[服務容器](服務容器.md)?中注冊綁定,您可以選擇推遲其注冊,直到真正需要注冊綁定時。延遲加載服務提供者將提高應用程序的性能,因為它不會每次都從文件系統中加載。
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];
}
}
~~~
- 前言
- 翻譯說明
- 發行說明
- 升級說明
- 貢獻導引
- 入門指南
- 安裝
- 配置信息
- 文件夾結構
- 請求周期
- 開發環境部署
- Homestead
- Valet
- 核心概念
- 服務容器
- 服務提供者
- Facades
- Contracts
- HTTP層
- 路由
- 中間件
- CSRF 保護
- 控制器
- 請求
- 響應
- 視圖
- Session
- 表單驗證
- 前端
- Blade 模板
- 本地化
- 前端指南
- 編輯資源 Mix
- 安全
- 用戶認證
- Passport OAuth 認證
- 用戶授權
- 加密解密
- 哈希
- 重置密碼
- 綜合話題
- Artisan 命令行
- 廣播系統
- 緩存系統
- 集合
- 錯誤與日志
- 事件系統
- 文件存儲
- 輔助函數
- 郵件發送
- 消息通知
- 擴展包開發
- 隊列
- 任務調度
- 數據庫
- 快速入門
- 查詢構造器
- 分頁
- 數據庫遷移
- 數據填充
- Redis
- Eloquent ORM
- 快速入門
- 模型關聯
- Eloquent 集合
- 修改器
- 序列化
- 測試
- 快速入門
- HTTP 測試
- 瀏覽器測試 Dusk
- 數據庫測試
- 測試模擬器
- 官方擴展包
- Cashier 交易工具包
- Envoy 部署工具
- Scout 全文搜索
- Socialite 社會化登錄