【laravel7.x中文文档】服务容器
Laravel是一个用于管理类依赖以及实现依赖注入的强有力工具。依赖注入这个名词表面看起来花哨,实质上是指:通过构造函数,或者某些情况下通过「setter」方法将类依赖「注入」到类中。
我们来看一个简单的例子:
<?php
namespace App\Http\Controllers;
use App\Http\Controllers\Controller;
use App\Repositories\UserRepository;
use App\User;
class UserController extends Controller
{
/**
* user仓储的实现
*
* @var UserRepository
*/
protected $users;
/**
* 创建一个新的控制器实例
*
* @param UserRepository $users
* @return void
*/
public function __construct(UserRepository $users)
{
$this->users = $users;
}
/**
* 展示给定用户的信息
*
* @param int $id
* @return Response
*/
public function show($id)
{
$user = $this->users->find($id);
return view('user.profile', ['user' => $user]);
}
}
在这个例子中,UserController
控制器需要从数据源中获取 users。所以,我们可以注入一个能够获取users的服务。在这种情况下,我们的存储仓库 UserRepository
极有可能使用Eloquent 从数据库中获取用户信息。然而,因为 repository
是通过 UserRepository
注入的,我们可以很轻易的将其切换为另一个实现。另外,这种方式的便利之处也体现在:当需要为应用编写测试的时候,我们也可以很轻松地“模拟”或者创建一个 UserRepository
存储层的伪实现来操作。
深入理解服务容器,对于构建一个强大的、大型的应用,以及对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;
/**
* Create a new class instance.
*
* @param EventPusher $pusher
* @return void
*/
public function __construct(EventPusher $pusher)
{
$this->pusher = $pusher;
}
有时你可能有两个类使用了相同的接口,但你希望各自注入不同的实现。例如, 有两个控制器可能依赖了 Illuminate\Contracts\Filesystem\Filesystem
契约. Laravel 提供了一个简单的,优雅的接口来定义这个行为:
use App\Http\Controllers\PhotoController;
use App\Http\Controllers\UploadController;
use App\Http\Controllers\VideoController;
use Illuminate\Contracts\Filesystem\Filesystem;
use Illuminate\Support\Facades\Storage;
$this->app->when(PhotoController::class)
->needs(Filesystem::class)
->give(function () {
return Storage::disk('local');
});
$this->app->when([VideoController::class, UploadController::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, $app) {
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
{
/**
* The user repository instance.
*/
protected $users;
/**
* Create a new controller instance.
*
* @param UserRepository $users
* @return void
*/
public function __construct(UserRepository $users)
{
$this->users = $users;
}
/**
* Show the user with the given ID.
*
* @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"...
});
正如你所看到的,被解析的对象将会被传入回调函数,这使得你能够在对象被传给调用者之前给它设置额外的属性。
Laravel 的服务容器实现了 PSR-11 接口。因此,你可以使用 PSR-11 容器 『接口类型提示』 来获取 Laravel 容器的实例:
use Psr\Container\ContainerInterface;
Route::get('/', function (ContainerInterface $container) {
$service = $container->get('Service');
//
});
如果无法解析给定的标识符,则将会引发异常。未绑定标识符时,会抛出 Psr\Container\NotFoundExceptionInterface
异常。如果标识符已绑定但无法解析,会抛出 Psr\Container\ContainerExceptionInterface
异常。