服务容器

本文档最新版为 7.x,旧版本可能放弃维护,推荐阅读最新版!

服务容器

简介

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

来看一个简单的例子:

<?php

namespace App\Http\Controllers;

use App\User;
use App\Repositories\UserRepository;
use App\Http\Controllers\Controller;

class UserController extends Controller
{
    /**
     * 用户存储库的实现
     *
     * @var UserRepository
     */
    protected $users;

    /**
     * 创建新的控制器实例
     *
     * @param  UserRepository  $users
     * @return void
     */
    public function __construct(UserRepository $users)
    {
        $this->users = $users;
    }

    /**
     * 显示指定用户的 profile
     *
     * @param  int  $id
     * @return Response
     */
    public function show($id)
    {
        $user = $this->users->find($id);

        return view('user.profile', ['user' => $user]);
    }
}

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

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

绑定

绑定基础

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

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

简单绑定

在服务提供器中,你总是可以通过 $this->app 属性访问容器。我们可以通过容器的 bind 方法注册绑定,bind 方法的第一个参数为要绑定的类/接口名,第二个参数是一个返回类实例的 Closure

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

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

绑定一个单例

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

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

绑定实例

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

$api = new HelpSpot\API(new HttpClient);

$this->app->instance('HelpSpot\API', $api);

绑定基本值

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

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

绑定接口到实现

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

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

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

use App\Contracts\EventPusher;

/**
 * 创建新的类实例
 *
 * @param  EventPusher  $pusher
 * @return void
 */
public function __construct(EventPusher $pusher)
{
    $this->pusher = $pusher;
}

上下文绑定

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

use Illuminate\Support\Facades\Storage;
use App\Http\Controllers\PhotoController;
use App\Http\Controllers\VideoController;
use Illuminate\Contracts\Filesystem\Filesystem;

$this->app->when(PhotoController::class)
          ->needs(Filesystem::class)
          ->give(function () {
              return Storage::disk('local');
          });

$this->app->when(VideoController::class)
          ->needs(Filesystem::class)
          ->give(function () {
              return Storage::disk('s3');
          });

标记

有时候,你可能需要解析某个 "分类" 下的所有绑定。例如:你正在构建一个报表的聚合器,它接收一个包含不同 Report 接口实现的数组。注册了 Report 实现之后,你可以使用 tag 方法为它们分配标签:

$this->app->bind('SpeedReport', function () {
    //
});

$this->app->bind('MemoryReport', function () {
    //
});

$this->app->tag(['SpeedReport', 'MemoryReport'], 'reports');

一旦服务被标记,你就可以使用 tagged 方法轻松将它们全部解析:

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

扩展绑定

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

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

解析实例

make 方法

你可以使用 make 方法从容器中解析出类实例。make 方法接受一个你想要解析的类名或接口名:

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

如果你的代码处于无法访问 $app 变量的位置,则可用全局辅助函数 resolve 来解析:

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

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

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

自动注入

另外,并且更重要的是,你可以简单地使用"类型提示"的方式在类的构造函数中注入那些需要容器解析的依赖项,包括 控制器, 事件监听器, 队列任务, 中间件等。实际上,这才是大多数对象应该被容器解析的方式。

比如,你可以在控制器的构造函数中添加一个 repository 的类型提示,然后这个 repository 将会被自动解析并注入类中:

<?php

namespace App\Http\Controllers;

use App\Users\Repository as UserRepository;

class UserController extends Controller
{
    /**
     * user repository 实例
     */
    protected $users;

    /**
     * 创建一个新的控制器实例
     *
     * @param  UserRepository  $users
     * @return void
     */
    public function __construct(UserRepository $users)
    {
        $this->users = $users;
    }

    /**
     * 显示给定ID的user
     *
     * @param  int  $id
     * @return Response
     */
    public function show($id)
    {
        //
    }
}

容器事件

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

$this->app->resolving(function ($object, $app) {
    // Called when container resolves object of any type...
});

$this->app->resolving(HelpSpot\API::class, function ($api, $app) {
    // Called when container resolves objects of type "HelpSpot\API"...
});

如你所见,被解析的对象将被传入回调函数,这使得你能够在对象被传给调用者之前给它设置额外的属性。

PSR-11

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

use Psr\Container\ContainerInterface;

Route::get('/', function (ContainerInterface $container) {
    $service = $container->get('Service');

    //
});

{note} 如果标识符还没有被显式绑定到容器,那么调用 get 方法将会抛出异常。

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

本译文仅用于学习和交流目的,转载请务必注明文章译者、出处、和本文链接
我们的翻译工作遵照 CC 协议,如果我们的工作有侵犯到您的权益,请及时联系我们。
上一篇 下一篇
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
贡献者:3
讨论数量: 13
发起讨论 只看当前版本


Zealot
有人和我一样很难理解此章节吗?
4 个点赞 | 15 个回复 | 问答 | 课程版本 5.6
myIvan
这章有点难啊
1 个点赞 | 1 个回复 | 问答 | 课程版本 5.8
wythe00
服务容器?
1 个点赞 | 1 个回复 | 问答 | 课程版本 5.6
xiaocailc
对 Laravel 服务容器解析章节不是很懂?
0 个点赞 | 3 个回复 | 问答 | 课程版本 5.6
pikalu
自动注入 需要先绑定吗
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
LeoRoll
Service Container 有俩地方感觉应该这样翻译
0 个点赞 | 2 个回复 | 分享 | 课程版本 5.5
LaravelWorldP
服务容器
0 个点赞 | 1 个回复 | 教程 | 课程版本 5.7
zongzigege
理解不了服务容器的原理
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.4
franktrue
有那些依赖项不能通过容器解析?
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.6
phpwlf54
不懂啊
1 个点赞 | 0 个回复 | 分享 | 课程版本 5.8