laravel5.5服务提供器

目录

• 1. 编写服务提供器
  • 1.1 注册方法 register
    • 1.1.1 简单绑定
    • 1.1.2 绑定单例
    • 1.1.3 绑定实例
    • 1.1.4 绑定初始数据
  • 1.2 引导方法 boot
• 2. 注册服务提供器
• 3. 解析
  • 3.1 make 方法
  • 3.2 自动注入
• 4. 绑定方法详解
  • 4.1 绑定接口到实现
  • 4.2 上下文绑定
  • 4.3 标记
• 5. 延迟提供器
• 6. 容器事件

你的应用程序以及 Laravel 的所有核心服务都是通过服务提供器进行引导（注册），服务提供器是配置你的应用程序的中心。

Laravel 的 config/app.php 文件中有一个 providers 数组。数组中的内容是应用程序要加载的所有服务提供器类。这其中有许多提供器并不会在每次请求时都被加载，只有当它们提供的服务实际需要时才会加载。这种我们称之为「延迟」提供器，推迟加载这种提供器会提高应用程序的性能。

1. 编写服务提供器

生成文件：

php artisan make:provider RiakServiceProvider

运行后会发现生成了app/Providers/RiakServiceProvider.php文件

生成文件内容：

<?php

namespace AppProviders;

use IlluminateSupportServiceProvider;

class RiakServiceProvider extends ServiceProvider
{
    /** 
     * Bootstrap the application services.
     *
     * @return void
     */
    public function boot()
    {   
        //  
    }

    /** 
     * Register the application services.
     *
     * @return void
     */
    public function register()
    {   
        //  
    }
}

从以上文件可以看出：

• 所有服务提供器都会继承 IlluminateSupportServiceProvider 类。
• 大多数服务提供器都包含 register 和 boot 方法

1.1 注册方法 register

只是单纯的绑定，不注册任何时间的监听器、路由、或者其它任何功能，否则你可能使用到未加载的服务

在你的任何服务提供器方法中，你可以通过 $app 属性来访问服务容器：

1.1.1 简单绑定

传递我们想要注册的类或接口名称再返回类的实例的 Closure ：

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

1.1.2 绑定单例

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

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

1.1.3 绑定实例

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

$api = new HelpSpotAPI(new HttpClient);

$this->app->instance('HelpSpotAPI', $api);

1.1.4 绑定初始数据

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

$this->app->when('AppHttpControllersUserController')
          ->needs('$variableName')
          ->give($value);

1.2 引导方法 boot

此方法在所有其它服务提供者都注册之后才调用，我们可以访问所以已经被框架注册的服务，比如我们想实现某个功能，比如中间件功能，事件监听等，你甚至可以在这里注册一条路由，这样就可以是这条路由生效了

public function boot()
{
    view()->composer('view', function () {
        //
    });
}

可以在boot方法使用依赖注入

use IlluminateContractsRoutingResponseFactory;

//使用了类型提示
public function boot(ResponseFactory $response)
{
    $response->macro('caps', function ($value) {
        //
    });
}

2. 注册服务提供器

创建好服务提供者之后需要在config/app.php配置文件中注册，写在providers数组中。

'providers' => [
    // 其他服务提供器

    AppProvidersComposerServiceProvider::class,
],

3. 解析

3.1 make 方法

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

$api = $this->app->make('HelpSpotAPI');

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

$api = resolve('HelpSpotAPI');

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

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

3.2 自动注入

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

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

<?php

namespace AppHttpControllers;

use AppUsersRepository as UserRepository;

class UserController extends Controller
{
    /**
     * 用户存储库实例。
     */
    protected $users;

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

    /**
     * 显示指定 ID 的用户信息。
     *
     * @param  int  $id
     * @return Response
     */
    public function show($id)
    {
        //
    }
}

4. 绑定方法详解

上面谈到了注册方法中的绑定，我们要指到服务容器有一个强大的功能，就是将接口绑定到给定实现。

4.1 绑定接口到实现

例如，如果我们有一个 EventPusher 接口和一个 RedisEventPusher 实现。编写完接口的 RedisEventPusher 实现后，我们就可以在服务容器中注册它，像这样：

$this->app->bind(
    'AppContractsEventPusher',
    'AppServicesRedisEventPusher'
);

使用也很简单，可以在构造函数或者任何其他通过服务容器注入依赖项的地方使用类型提示注入 EventPusher 接口：

use AppContractsEventPusher;

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

分析以上的代码，当一个类需要实现 EventPusher 时，应该注入 RedisEventPusher，我们可能在更多的地方注入EventPusher，有一天我们想换成memcachedEventPusher，再想想，是不是发现了，我们不必去一个个修改每一个使用EventPusher的类，我们只需要在服务提供器这里修改就可以了。

$this->app->bind(
    'AppContractsEventPusher',
    'AppServicesmemcachedEventPusher'
);

4.2 上下文绑定

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

use IlluminateSupportFacadesStorage;
use AppHttpControllersPhotoController;
use AppHttpControllersVideoController;
use IlluminateContractsFilesystemFilesystem;

$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');
          });

4.3 标记

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

5. 延迟提供器

推迟其注册，提高性能，只有在尝试解析其中的服务时候才会加载服务提供者。

要延迟提供器的加载，请将 defer 属性设置为 true ，并定义 provides 方法。provides 方法应该返回由提供器注册的服务容器绑定：

<?php

namespace AppProviders;

use RiakConnection;
use IlluminateSupportServiceProvider;

class RiakServiceProvider extends ServiceProvider
{
    //1.是否延时加载服务提供者
    protected $defer = true;

    public function register()
    {
        $this->app->singleton(Connection::class, function ($app) {
            return new Connection($app['config']['riak']);
        });
    }

    //2.定义provides方法，返回由提供器注册的服务容器绑定
    public function provides()
    {
        return [Connection::class];
    }

}

6. 容器事件

在给消费者使用前，可以做最后一步监听修改（Container Events）

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

$this->app->resolving(function ($object, $app) {
    // 当容器解析任何类型的对象时调用...
});

$this->app->resolving(HelpSpotAPI::class, function ($api, $app) {
    // 当容器解析类型为「HelpSpotAPI」的对象时调用...
});

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