【Laravel5.2翻译】服务提供者


前阵子看了点Laravel源码,越看越乱,网上大部分中文文档都是直译,比较生涩难懂,还是决定看英文文档顺便就我的理解做下翻译整理记录下来


【Laravel5.2翻译】服务提供者_第1张图片
思维导图

简介

服务提供者是整个Laravel应用引导的核心。你的应用,以及所有Laravel核心服务都通过服务提供者引导。
但是,我们怎么理解“引导”这个词呢?通常来说,我们的意思是注册一些东西,包含注册服务容器绑定、事件监听、中间件还有路由。服务提供者是配置应用的中心。
如果打开Laravel中的config/app.php文件,你会看到providers数组。这些是所有将被应用加载的服务提供者。当然,其中很多都是“延时”提供者,意思是只会在真的需要它们提供的服务的时候被加载,而不会每次请求都被加载。
在这篇文章中,你将学会如何编写自己的服务提供者注册到应用程序。

编写服务提供者

所有的服务提供者都继承Illuminate\Support\ServiceProvider类。这个抽象类要求你至少在你的provider上定义一个方法:register。在这个方法中。你只能往service container内绑定东西。不要试图去注册任何事件监听,路由和其他功能模块。

用Artisan CLI的make:provider命令可以很容易生成一个新的provider:

php artisan make:provider RiakServiceProvider
Register方法

就像我们前面提到的,在register方法中,你只能往service container里绑东西,而不要试图去做其他事情。否则,你将有可能意外地使用其他没有被加载的服务提供者提供的服务。

现在,让我们看一下一个基础的service provider:

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

这个服务提供者只是定义了一个register方法,其中用方法在service Container中定义了一个Riak\Connection实现。

Boot方法

那,如果我们需要在service container中注册是一个view composer怎么办法呢?
这件事需要在boot方法中做。这个方法会在所有其他服务提供者被注册后呼叫,意味着你可以访问所有被框架注册的其他服务:

composer('view', function () {
            //
        });
    }
}
Boot方法的依赖注入

你可以为boot方法类型提示依赖。服务容器会自动注入任何你需要的依赖:

use Illuminate\Contracts\Routing\ResponseFactory;

public function boot(ResponseFactory $factory)
{
    $factory->macro('caps', function ($value) {
        //
    });
}

注册容器

所有的服务提供者在config/app.php配置文件中注册。这个文件包含providers数组,其中可以列出了服务提供者的名称。默认情况下,一组Laravel核心服务提供者会被列在这个数组里。这些提供者引导Laravel的核心组件,例如邮件、队列、缓存等等。

注册你自己的提供者,只要简单把它加入到这个数组中:

'providers' => [
    // Other Service Providers

    App\Providers\AppServiceProvider::class,
],

延迟提供者

如果你的提供者只是在服务容器中注册bindings,你可以选择延迟注册直到其中一个被注册的bindings真的被用到。让这样的提供者延时被加载可以提升你应用的性能,因为它不会在每次请求都从文件系统中被加载。

实现provider的延时加载,只需要把defer属性设置成true同时定义一个provides方法。这个provides方法返回提供者注册的服务容器bindings:

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

    /**
     * Get the services provided by the provider.
     *
     * @return array
     */
    public function provides()
    {
        return [Connection::class];
    }

}

Laravel通过服务提供者class名 ,编译和保存所有由延时服务提供者支持的服务。只有当你试图使用其中一种服务,Laravel才会加载服务提供者。

你可能感兴趣的:(【Laravel5.2翻译】服务提供者)