服务定位器（Service Locator）

服务定位器是一个了解如何提供各种应用所需的服务（或组件）的对象。在服务定位器中，
每个组件都只有一个单独的实例，并通过ID 唯一地标识。
用这个 ID 就能从服务定位器中得到这个组件。

在 Yii 中，服务定位器是 [[yii\di\ServiceLocator]] 或其子类的一个实例。

最常用的服务定位器是application（应用）对象，可以通过 \Yii::$app 访问。
它所提供的服务被称为application components（应用组件），
比如：request、response、urlManager 组件。可以通过服务定位器所提供的功能，
非常容易地配置这些组件，或甚至是用你自己的实现替换掉他们。

除了 application 对象，每个模块对象本身也是一个服务定位器。

要使用服务定位器，第一步是要注册相关组件。组件可以通过 [[yii\di\ServiceLocator::set()]] 方法进行注册。
以下的方法展示了注册组件的不同方法：

  1. use yii\di\ServiceLocator;
  2. use yii\caching\FileCache;
  4. $locator = new ServiceLocator;
  6. // 通过一个可用于创建该组件的类名，注册 "cache" （缓存）组件。
  7. $locator->set('cache', 'yii\caching\ApcCache');
  9. // 通过一个可用于创建该组件的配置数组，注册 "db" （数据库）组件。
  10. $locator->set('db', [
  11.     'class' => 'yii\db\Connection',
  12.     'dsn' => 'mysql:host=localhost;dbname=demo',
  13.     'username' => 'root',
  14.     'password' => '',
  15. ]);
  17. // 通过一个能返回该组件的匿名函数，注册 "search" 组件。
  18. $locator->set('search', function () {
  19.     return new app\components\SolrService;
  20. });
  22. // 用组件注册 "pageCache" 组件
  23. $locator->set('pageCache', new FileCache);

一旦组件被注册成功，你可以任选以下两种方式之一，通过它的 ID 访问它：

  1. $cache = $locator->get('cache');
  2. // 或者
  3. $cache = $locator->cache;

如上所示， [[yii\di\ServiceLocator]] 允许通过组件 ID 像访问一个属性值那样访问一个组件。
当你第一次访问某组件时，[[yii\di\ServiceLocator]]
会通过该组件的注册信息创建一个该组件的实例，并返回它。
之后，如果再次访问，则服务定位器会返回同一个实例。

你可以通过 [[yii\di\ServiceLocator::has()]] 检查某组件 ID 是否被注册。
若你用一个无效的 ID 调用 [[yii\di\ServiceLocator::get()]]，则会抛出一个异常。

因为服务定位器，经常会在创建时附带配置信息，
因此我们提供了一个可写的属性，名为 [[yii\di\ServiceLocator::setComponents()|components]]，
这样就可以配置该属性，或一次性注册多个组件。
下面的代码展示了如何用一个配置数组，配置一个应用并注册
db，cache，tz 和 search 组件：

  1. return [
  2.     // ...
  3.     'components' => [
  4.         'db' => [
  5.             'class' => 'yii\db\Connection',
  6.             'dsn' => 'mysql:host=localhost;dbname=demo',
  7.             'username' => 'root',
  8.             'password' => '',
  9.         ],
  10.         'cache' => 'yii\caching\ApcCache',
  11.         'tz' => function() {
  12.             return new \DateTimeZone(Yii::$app->formatter->defaultTimeZone);
  13.         },
  14.         'search' => function () {
  15.             $solr = new app\components\SolrService('127.0.0.1');
  16.             // ... other initializations ...
  17.             return $solr;
  18.         },
  19.     ],
  20. ];

在上面的代码中，有一个替代方法来配置 search 组件。
而不是直接写一个 PHP 回调建立 SolrService实例，你可以使用一个静态类方法来返回这样的回调，
如下所示：

  1. class SolrServiceBuilder
  2. {
  3.     public static function build($ip)
  4.     {
  5.         return function () use ($ip) {
  6.             $solr = new app\components\SolrService($ip);
  7.             // ... other initializations ...
  8.             return $solr;
  9.         };
  10.     }
  11. }
  13. return [
  14.     // ...
  15.     'components' => [
  16.         // ...
  17.         'search' => SolrServiceBuilder::build('127.0.0.1'),
  18.     ],
  19. ];

当你发布一个 Yii 组件封装一些非 Yii 第三方库时，这种替代方法是最好的。
当您使用如上所示的静态方法来表示构建复杂逻辑的第三方对象时，
您的组件用户只需要调用静态方法来配置组件。

" class="reference-link">遍历树（Tree traversal）

模块允许任意嵌套; Yii 应用程序本质上是一个模块树。
由于这些模块中的每一个都是服务定位器，所以子模块有权限访问其父模块。
这允许模块使用 $this->get('db') 而不是引用根服务定位器 Yii::$app->get('db')。
增加的好处是开发人员可以覆盖模块中的配置。

如果模块无法满足要求，则从模块中检索服务的请求将被传递给它的父模块。

请注意，模块中组件的配置决不会与来自父模块中组件的配置合并。Service Locator 模式允许我们定义命名服务，但不能假定具有相同名称的服务使用相同的配置参数。