服务容器

简介

Laravel 服务容器是管理类依赖与运行依赖注入的强力工具。依赖注入是个花俏的名词,事实上是指:类的依赖通过构造器或在某些情况下通过「setter」方法「注入」。

让我们来看个简单例子:

  1. <?php
  2. namespace App\Jobs;
  3. use App\User;
  4. use Illuminate\Contracts\Mail\Mailer;
  5. use Illuminate\Contracts\Bus\SelfHandling;
  6. class PurchasePodcast implements SelfHandling
  7. {
  8. /**
  9. * 邮件寄送器的实现。
  10. */
  11. protected $mailer;
  12. /**
  13. * 创建一个新实例。
  14. *
  15. * @param Mailer $mailer
  16. * @return void
  17. */
  18. public function __construct(Mailer $mailer)
  19. {
  20. $this->mailer = $mailer;
  21. }
  22. /**
  23. * 购买一个播客
  24. *
  25. * @return void
  26. */
  27. public function handle()
  28. {
  29. //
  30. }
  31. }

在这例子中,当播客被购买时,PurchasePodcast 任务会需要寄送 e-mails。因此,我们将 注入 能寄送 e-mails 的服务。由于服务被注入,我们能容易地切换成其它实现。当测试应用程序时,我们能轻易地「mock」,或创建假的邮件寄送器实现。

在构建强大的应用程序,以及为 Laravel 核心贡献代码时,须深入理解 Laravel 服务容器。

绑定

几乎所有的服务容器绑定都会注册至 服务提供者 中,所以下方所有的例子将示范在该情境中使用容器。不过,如果它们没有依赖任何的接口,那么就没有将类绑定至容器中的必要。并不需要为容器指定如何建构这些对象,因为它会通过 PHP 的反射服务自动解析「实际」的对象。

在服务提供者中,你总是可以通过 $this->app 实例变量访问容器。我们可以使用 bind 方法注册一个绑定,传递我们希望注册的类或接口名称,并连同返回该类实例的闭包

  1. $this->app->bind('HelpSpot\API', function ($app) {
  2. return new HelpSpot\API($app['HttpClient']);
  3. });

注意,我们获取到的容器本身作为参数传递给解析器,这样就可以使用容器来解析绑定对象的 次要依赖

绑定一个单例

singleton 方法绑定一个只会被解析一次的类或接口至容器中,且后面的调用都会从容器中返回相同的实例:

  1. $this->app->singleton('FooBar', function ($app) {
  2. return new FooBar($app['SomethingElse']);
  3. });

绑定实例

你也可以使用 instance 方法,绑定一个已经存在的对象实例至容器中。后面的调用都会从容器中返回指定的实例:

  1. $fooBar = new FooBar(new SomethingElse);
  2. $this->app->instance('FooBar', $fooBar);

绑定接口至实现

服务容器有个非常强大的特色功能,就是能够将指定的实现绑定至接口。举个例子,让我们假设我们有个 EventPusher 接口及一个 RedisEventPusher 实现。一旦我们编写完该接口的 RedisEventPusher 实现,就可以将它注册至服务容器:

  1. $this->app->bind('App\Contracts\EventPusher', 'App\Services\RedisEventPusher');

这么做会告知容器当有个类需要 EventPusher 的实现时,必须注入 RedisEventPusher。现在我们可以在构造器中对 EventPusher 接口使用类型提示,或任何需要通过服务容器注入依赖的其它位置:

  1. use App\Contracts\EventPusher;
  2. /**
  3. * 创建一个新的类实例。
  4. *
  5. * @param EventPusher $pusher
  6. * @return void
  7. */
  8. public function __construct(EventPusher $pusher)
  9. {
  10. $this->pusher = $pusher;
  11. }

情境绑定

有时候,你可能有两个类使用到相同接口,但你希望每个类都能注入不同实现。例如,当系统收到新订单时,我们可能想通过 PubNub 来发送事件,而不是 Pusher。Laravel 提供一个简单流畅的接口来定义此行为:

  1. $this->app->when('App\Handlers\Commands\CreateOrderHandler')
  2. ->needs('App\Contracts\EventPusher')
  3. ->give('App\Services\PubNubEventPusher');

你甚至可以传递一个闭包至 give 方法:

  1. $this->app->when('App\Handlers\Commands\CreateOrderHandler')
  2. ->needs('App\Contracts\EventPusher')
  3. ->give(function () {
  4. // Resolve dependency...
  5. });

标记

有些时候,可能需要解析某个「分类」下的所有绑定。例如,你正在构建一个能接收多个不同 Report 接口实现数组的报表汇整器。注册完 Report 实现后,可以使用 tag 方法为它们赋予一个标签:

  1. $this->app->bind('SpeedReport', function () {
  2. //
  3. });
  4. $this->app->bind('MemoryReport', function () {
  5. //
  6. });
  7. $this->app->tag(['SpeedReport', 'MemoryReport'], 'reports');

一旦服务被标记之后,你可以通过 tagged 方法将它们全部解析:

  1. $this->app->bind('ReportAggregator', function ($app) {
  2. return new ReportAggregator($app->tagged('reports'));
  3. });

解析

有几种方式可以从容器中解析一些东西。首先,你可以使用 make 方法,它会接收你希望解析的类或是接口的名称:

  1. $fooBar = $this->app->make('FooBar');

或者,你可以像数组一样从容器中进行访问,因为他实现了 PHP 的 ArrayAccess 接口:

  1. $fooBar = $this->app['FooBar'];

最后,也是最重要的,你可以在类的构造器简单地对依赖使用「类型提示」,类将会从容器中进行解析,包含 控制器事件侦听器队列任务中间件 等等。在实际情形中,这就是为何大部分的对象都是在容器中解析的。

容器会自动为类注入解析出的依赖。举个例子,你可以在控制器的构造器中对应用程序定义的 Repository 进行类型提示。Repository 会自动被解析及注入至类中:

  1. <?php
  2. namespace App\Http\Controllers;
  3. use Illuminate\Routing\Controller;
  4. use App\Users\Repository as UserRepository;
  5. class UserController extends Controller
  6. {
  7. /**
  8. * 用户 Repository 的实例。
  9. */
  10. protected $users;
  11. /**
  12. * 创建一个新的控制器实例。
  13. *
  14. * @param UserRepository $users
  15. * @return void
  16. */
  17. public function __construct(UserRepository $users)
  18. {
  19. $this->users = $users;
  20. }
  21. /**
  22. * 显示指定 ID 的用户。
  23. *
  24. * @param int $id
  25. * @return Response
  26. */
  27. public function show($id)
  28. {
  29. //
  30. }
  31. }

容器事件

每当服务容器解析一个对象时就会触发事件。你可以使用 resolving 方法监听这个事件:

  1. $this->app->resolving(function ($object, $app) {
  2. // 当容器解析任何类型的对象时会被调用...
  3. });
  4. $this->app->resolving(FooBar::class, function (FooBar $fooBar, $app) {
  5. // 当容器解析「FooBar」类型的对象时会被调用...
  6. });

如你所见,被解析的对象会被传递至回调中,让你可以在传递前设置任何额外属性到对象上。


{note} 欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。

转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译。

文档永久地址: http://d.laravel-china.org