# 服務定位器
服務定位器是一個了解如何提供各種應用所需的服務(或組件)的對象。在服務定位器中,每個組件都只有一個單獨的實例,并通過ID 唯一地標識。用這個 ID 就能從服務定位器中得到這個組件。
在 Yii 中,服務定位器是 yii\di\ServiceLocator 或其子類的一個實例。
最常用的服務定位器是**application(應用)**對象,可以通過?`\Yii::$app`?訪問。它所提供的服務被稱為**application components(應用組件)**,比如:`request`、`response`、`urlManager`?組件。可以通過服務定位器所提供的功能,非常容易地配置這些組件,或甚至是用你自己的實現替換掉他們。
除了 application 對象,每個模塊對象本身也是一個服務定位器。
要使用服務定位器,第一步是要注冊相關組件。組件可以通過 yii\di\ServiceLocator::set() 方法進行注冊。以下的方法展示了注冊組件的不同方法:
~~~
use yii\di\ServiceLocator;
use yii\caching\FileCache;
$locator = new ServiceLocator;
// 通過一個可用于創建該組件的類名,注冊 "cache" (緩存)組件。
$locator->set('cache', 'yii\caching\ApcCache');
// 通過一個可用于創建該組件的配置數組,注冊 "db" (數據庫)組件。
$locator->set('db', [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=demo',
'username' => 'root',
'password' => '',
]);
// 通過一個能返回該組件的匿名函數,注冊 "search" 組件。
$locator->set('search', function () {
return new app\components\SolrService;
});
// 用組件注冊 "pageCache" 組件
$locator->set('pageCache', new FileCache);
~~~
一旦組件被注冊成功,你可以任選以下兩種方式之一,通過它的 ID 訪問它:
~~~
$cache = $locator->get('cache');
// 或者
$cache = $locator->cache;
~~~
如上所示, yii\di\ServiceLocator 允許通過組件 ID 像訪問一個屬性值那樣訪問一個組件。當你第一次訪問某組件時,yii\di\ServiceLocator 會通過該組件的注冊信息創建一個該組件的實例,并返回它。之后,如果再次訪問,則服務定位器會返回同一個實例。
你可以通過 yii\di\ServiceLocator::has() 檢查某組件 ID 是否被注冊。若你用一個無效的 ID 調用 yii\di\ServiceLocator::get(),則會拋出一個異常。
因為服務定位器,經常會在創建時附帶[配置信息](http://www.yiichina.com/doc/guide/2.0/concept-configurations),因此我們提供了一個可寫的屬性,名為 yii\di\ServiceLocator::setComponents(),這樣就可以配置該屬性,或一次性注冊多個組件。下面的代碼展示了如何用一個配置數組,配置一個應用并注冊"db","cache" 和 "search" 三個組件:?`````php return [
~~~
// ...
'components' => [
'db' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=demo',
'username' => 'root',
'password' => '',
],
'cache' => 'yii\caching\ApcCache',
'search' => function () {
return new app\components\SolrService;
},
],
~~~
];?`````
- 介紹(Introduction)
- 關于 Yii(About Yii)
- 從 Yii 1.1 升級(Upgrading from Version 1.1)
- 入門(Getting Started)
- 安裝 Yii(Installing Yii)
- 運行應用(Running Applications)
- 第一次問候(Saying Hello)
- 使用 Forms(Working with Forms)
- 玩轉 Databases(Working with Databases)
- 用 Gii 生成代碼(Generating Code with Gii)
- 更上一層樓(Looking Ahead)
- 應用結構(Application Structure)
- 結構概述(Overview)
- 入口腳本(Entry Scripts)
- 應用(Applications)
- 應用組件(Application Components)
- 控制器(Controllers)
- 模型(Models)
- 視圖(Views)
- 模塊(Modules)
- 過濾器(Filters)
- 小部件(Widgets)
- 前端資源(Assets)
- 擴展(Extensions)
- 請求處理(Handling Requests)
- 運行概述(Overview)
- 引導(Bootstrapping)
- 路由引導與創建 URL(Routing and URL Creation)
- 請求(Requests)
- 響應(Responses)
- Sessions and Cookies
- 錯誤處理(Handling Errors)
- 日志(Logging)
- 關鍵概念(Key Concepts)
- 組件(Components)
- 屬性(Properties)
- 事件(Events)
- 行為(Behaviors)
- 配置(Configurations)
- 別名(Aliases)
- 類自動加載(Class Autoloading)
- 服務定位器(Service Locator)
- 依賴注入容器(Dependency Injection Container)
- 配合數據庫工作(Working with Databases)
- 數據庫訪問(Data Access Objects): 數據庫連接、基本查詢、事務和模式操作
- 查詢生成器(Query Builder): 使用簡單抽象層查詢數據庫
- 活動記錄(Active Record): 活動記錄對象關系映射(ORM),檢索和操作記錄、定義關聯關系
- 數據庫遷移(Migrations): 在團體開發中對你的數據庫使用版本控制
- Sphinx
- Redis
- MongoDB
- ElasticSearch
- 接收用戶數據(Getting Data from Users)
- 創建表單(Creating Forms)
- 輸入驗證(Validating Input)
- 文件上傳(Uploading Files)
- 收集列表輸入(Collecting Tabular Input)
- 多模型同時輸入(Getting Data for Multiple Models)
- 顯示數據(Displaying Data)
- 格式化輸出數據(Data Formatting)
- 分頁(Pagination)
- 排序(Sorting)
- 數據提供器(Data Providers)
- 數據小部件(Data Widgets)
- 操作客戶端腳本(Working with Client Scripts)
- 主題(Theming)
- 安全(Security)
- 認證(Authentication)
- 授權(Authorization)
- 處理密碼(Working with Passwords)
- 客戶端認證(Auth Clients)
- 安全領域的最佳實踐(Best Practices)
- 緩存(Caching)
- 概述(Overview)
- 數據緩存(Data Caching)
- 片段緩存(Fragment Caching)
- 分頁緩存(Page Caching)
- HTTP 緩存(HTTP Caching)
- RESTful Web 服務
- 快速入門(Quick Start)
- 資源(Resources)
- 控制器(Controllers)
- 路由(Routing)
- 格式化響應(Response Formatting)
- 授權驗證(Authentication)
- 速率限制(Rate Limiting)
- 版本化(Versioning)
- 錯誤處理(Error Handling)
- 開發工具(Development Tools)
- 調試工具欄和調試器(Debug Toolbar and Debugger)
- 使用 Gii 生成代碼(Generating Code using Gii)
- TBD 生成 API 文檔(Generating API Documentation)
- 測試(Testing)
- 概述(Overview)
- 搭建測試環境(Testing environment setup)
- 單元測試(Unit Tests)
- 功能測試(Functional Tests)
- 驗收測試(Acceptance Tests)
- 測試夾具(Fixtures)
- 高級專題(Special Topics)
- 高級應用模版(Advanced Project Template)
- 從頭構建自定義模版(Building Application from Scratch)
- 控制臺命令(Console Commands)
- 核心驗證器(Core Validators)
- 國際化(Internationalization)
- 收發郵件(Mailing)
- 性能優化(Performance Tuning)
- 共享主機環境(Shared Hosting Environment)
- 模板引擎(Template Engines)
- 集成第三方代碼(Working with Third-Party Code)
- 小部件(Widgets)
- Bootstrap 小部件(Bootstrap Widgets)
- jQuery UI 小部件(jQuery UI Widgets)
- 助手類(Helpers)
- 助手一覽(Overview)
- Array 助手(ArrayHelper)
- Html 助手(Html)
- Url 助手(Url)