Laravel 服务容器解析

简介

Laravel 服务容器是用于管理类的依赖和执行依赖注入的工具。依赖注入这个花俏名词实质上是指:类的依赖项通过构造函数,或者某些情况下通过「setter」方法「注入」到类中。

来看一个简单的例子:

  1. <?php
  2. namespace App\Http\Controllers;
  3. use App\User;
  4. use App\Repositories\UserRepository;
  5. use App\Http\Controllers\Controller;
  6. class UserController extends Controller
  7. {
  8. /**
  9. * 用户存储库的实现。
  10. *
  11. * @var UserRepository
  12. */
  13. protected $users;
  14. /**
  15. * 创建新的控制器实例。
  16. *
  17. * @param UserRepository $users
  18. * @return void
  19. */
  20. public function __construct(UserRepository $users)
  21. {
  22. $this->users = $users;
  23. }
  24. /**
  25. * 显示指定用户的 profile。
  26. *
  27. * @param int $id
  28. * @return Response
  29. */
  30. public function show($id)
  31. {
  32. $user = $this->users->find($id);
  33. return view('user.profile', ['user' => $user]);
  34. }
  35. }

在这个例子中,控制器 UserController 需要从数据源中获取 users 。因此,我们要 注入 可以获取 users 的服务。在这种情况下,UserRepository 可能是使用 Eloquent 从数据库中获取 user 信息。因为 Repository 是通过 UserRepository 注入的,所以我们可以轻易地将其切换为另一个实现。这种注入方式的便利之处还体现在当我们为应用编写测试时,我们还可以轻松地「模拟」或创建 UserRepository 的虚拟实现。

想要构建强大的大型应用,至关重要的一件事是:要深刻的理解 Laravel 服务容器。当然,为 Laravel 的核心代码做出贡献也一样。

绑定

绑定基础

因为几乎所有服务容器绑定操作都是在 服务提供器 中注册的,所以文档中大多数例子都是使用了在服务提供器中绑定的容器。

{tip} 如果类没有依赖任何接口,就没有必要将类绑定到容器中。容器不需要指定如何构建这些对象,因为它可以使用反射自动解析这些对象。

简单绑定

在服务提供器中,你可以通过 $this->app 属性访问容器。我们可以通过 bind 方法注册绑定,传递我们想要注册的类或接口名称再返回类的实例的 Closure

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

注意,我们接受容器本身作为解析器的参数。然后,我们可以使用容器来解析正在构建的对象的子依赖。

绑定一个单例

singleton 方法将类或接口绑定到只能解析一次的容器中。绑定的单例被解析后,相同的对象实例会在随后的调用中返回到容器中:

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

绑定实例

你也可以使用 instance 方法将现有对象实例绑定到容器中。给定的实例会始终在随后的调用中返回到容器中:

  1. $api = new HelpSpot\API(new HttpClient);
  2. $this->app->instance('HelpSpot\API', $api);

绑定初始数据

当你有一个类不仅需要接受一个注入类,还需要注入一个基本值(比如整数)。你可以使用上下文绑定来轻松注入你的类需要的任何值:

  1. $this->app->when('App\Http\Controllers\UserController')
  2. ->needs('$variableName')
  3. ->give($value);

绑定接口到实现

服务容器有一个强大的功能,就是将接口绑定到给定实现。例如,如果我们有一个 EventPusher 接口和一个 RedisEventPusher 实现。编写完接口的 RedisEventPusher 实现后,我们就可以在服务容器中注册它,像这样:

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

这么做相当于告诉容器:当一个类需要实现 EventPusher 时,应该注入 RedisEventPusher。现在我们就可以在构造函数或者任何其他通过服务容器注入依赖项的地方使用类型提示注入 EventPusher 接口:

  1. use App\Contracts\EventPusher;
  2. /**
  3. * Create a new class instance.
  4. *
  5. * @param EventPusher $pusher
  6. * @return void
  7. */
  8. public function __construct(EventPusher $pusher)
  9. {
  10. $this->pusher = $pusher;
  11. }

上下文绑定

有时候,你可能有两个类使用了相同的接口,但你希望每个类都能注入不同的实现。例如,两个控制器可能需要依赖不同的 Illuminate\Contracts\Filesystem\Filesystem 契约 实现。 Laravel 提供了一个简单、优雅的接口来定义这个行为:

  1. use Illuminate\Support\Facades\Storage;
  2. use App\Http\Controllers\PhotoController;
  3. use App\Http\Controllers\VideoController;
  4. use Illuminate\Contracts\Filesystem\Filesystem;
  5. $this->app->when(PhotoController::class)
  6. ->needs(Filesystem::class)
  7. ->give(function () {
  8. return Storage::disk('local');
  9. });
  10. $this->app->when(VideoController::class)
  11. ->needs(Filesystem::class)
  12. ->give(function () {
  13. return Storage::disk('s3');
  14. });

标记

有时候,你可能需要解析某个「分类」下的所有绑定。例如,你正在构建一个报表的聚合器,它接收一个包含不同 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. });

扩展绑定

extend 方法可以修改解析的服务。例如,当一个服务被解析后,你可以添加额外的代码去修饰或配置这个服务。 extend 方法接受一个闭包,闭包的唯一参数和返回值都是一个服务:

  1. $this->app->extend(Service::class, function($service) {
  2. return new DecoratedService($service);
  3. });

解析实例

make 方法

你可以使用 make 方法将容器中的类实例解析出来。make 方法接受要解析的类或接口的名称:

  1. $api = $this->app->make('HelpSpot\API');

如果你的代码处于不能访问 $app 变量的位置,你可以使用全局的辅助函数 resolve

  1. $api = resolve('HelpSpot\API');

如果你的某些类的依赖项不能通过容器去解析,那你可以通过将它们作为关联数组传递到 makeWith 方法来注入它们。

  1. $api = $this->app->makeWith('HelpSpot\API', ['id' => 1]);

自动注入

你可以简单地使用「类型提示」的方式在由容器解析的类的构造函数中添加依赖项,包括 控制器监听事件队列任务中间件 等。 事实上,这是你的大多数对象也应该由容器解析。

例如,你可以在控制器的构造函数中对应用程序定义的 Repository 使用类型提示。Repository 会被自动解析并注入到类中:

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

容器事件

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

  1. $this->app->resolving(function ($object, $app) {
  2. // Called when container resolves object of any type...
  3. });
  4. $this->app->resolving(HelpSpot\API::class, function ($api, $app) {
  5. // Called when container resolves objects of type "HelpSpot\API"...
  6. });

如你所见,被解析的对象会被传递给回调中,让你在对象被传递出去之前可以在对象上设置任何属性。

PSR-11

Laravel 的服务容器实现了 PSR-11 接口。 因此,你可以使用 PSR-11容器『接口类型提示』来获取 Laravel 容器的实例:

  1. use Psr\Container\ContainerInterface;
  2. Route::get('/', function (ContainerInterface $container) {
  3. $service = $container->get('Service');
  4. //
  5. });

{note} 如果标签没有明确绑定到容器中,那么调用 get 方法时会抛出异常。

本文章首发在 LearnKu.com 网站上。

本文中的所有译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。