pembekal perkhidmatan
- Bootstrap Method
- start Suntikan Ketergantungan Kaedah
- Pembekal tertunda
- Pengenalan
- Pembekal Perkhidmatan Penulisan
- Pembekal Kelewatan
- Daftar Perkhidmatan pembekal
Pembekal Perkhidmatan
Pembekal perkhidmatan ialah pusat bootstrapping untuk semua aplikasi Laravel. Aplikasi anda, serta perkhidmatan teras Laravel yang di-boot melalui pelayan, di-bootstrap melalui pembekal perkhidmatan.
Tetapi apakah maksud "bimbingan"? Biasanya, kami boleh difahami sebagai
Pendaftaran, seperti mendaftarkan pengikatan kontena perkhidmatan, pendengar acara, perisian tengah, dan juga penghalaan. Pembekal perkhidmatan adalah pusat untuk mengkonfigurasi aplikasi. Apabila anda membuka fail config/app.php
Laravel, anda akan melihat tatasusunan pembekal
. Kandungan tatasusunan ialah kelas semua pembekal perkhidmatan yang akan dimuatkan oleh aplikasi. Sudah tentu, terdapat banyak pembekal "malas", yang tidak dimuatkan pada setiap permintaan, tetapi hanya apabila perkhidmatan mereka sebenarnya diperlukan.
Dalam artikel ini anda akan belajar cara menulis penyedia perkhidmatan anda sendiri dan mendaftarkannya dalam aplikasi Laravel andaconfig/app.php
文件时,你会看到 providers
数组。数组中的内容是应用程序要加载的所有服务提供者的类。当然,其中有很多 「延迟」 提供者,他们并不会在每次请求的时候都加载,只有他们的服务实际被需要时才会加载。
本篇你将会学到如何编写自己的服务提供者,并将其注册到你的 Laravel 应用程序中
编写服务提供者
所有的服务提供者都会继承 IlluminateSupportServiceProvider
类。 大多服务提供者都包含一个 register
和一个 boot
方法。在 register
方法中, 你只需要将事物绑定到服务容器。而不要尝试在 register
方法中注册任何监听器,路由,或者其他任何功能
使用 Artisan 命令行工具,通过 make:provider
命令可以生成一个新的提供者:
php artisan make:provider RiakServiceProvider
注册方法
如上所述,在 register
方法中,你只需要将服务绑定到服务容器中。而不要尝试在 register
方法中注册任何监听器,路由,或者其他任何功能。否则,你可能会意外地使用到尚未加载的服务提供者提供的服务。
让我们来看一个基础的服务提供者。在任何服务提供者方法中,你总是通过 $app
属性来访问服务容器:
<?php namespace App\Providers;use Riak\Connection; use Illuminate\Support\ServiceProvider; class RiakServiceProvider extends ServiceProvider{ /** * 在服务容器里注册 * * @return void */ public function register() { $this->app->singleton(Connection::class, function ($app) { return new Connection(config('riak')); }); } }
这个服务容器只是定义了一个 register
方法,并且使用该这个方法在服务容器中定义了一个 RiakConnection
IlluminateSupportServiceProvider
. Kebanyakan pembekal perkhidmatan mengandungi kaedah daftar
dan boot
. Dalam kaedah daftar
, anda hanya mengikat perkara itu pada bekas perkhidmatan. Jangan cuba mendaftar mana-mana pendengar, laluan atau mana-mana fungsi lain dalam kaedah register
🎜🎜Gunakan alat baris arahan Artisan untuk menjana yang baharu melalui make:provider
arahan Disediakan oleh: 🎜<?php namespace App\Providers; use App\Contracts\ServerProvider; use App\Contracts\DowntimeNotifier; use Illuminate\Support\ServiceProvider; use App\Services\PingdomDowntimeNotifier; use App\Services\DigitalOceanServerProvider; class AppServiceProvider extends ServiceProvider{ /** * 设定所有的容器绑定的对应关系 * * @var array */ public $bindings = [ ServerProvider::class => DigitalOceanServerProvider::class, ]; /** * 设定所有的单例模式容器绑定的对应关系 * * @var array */ public $singletons = [ DowntimeNotifier::class => PingdomDowntimeNotifier::class, ]; }🎜🎜🎜
Kaedah daftar
🎜Seperti yang dinyatakan di atas, dalam kaedahregister
, anda hanya perlu kepada Perkhidmatan diikat ke dalam bekas perkhidmatan. Jangan cuba mendaftar mana-mana pendengar, laluan atau sebarang fungsi lain dalam kaedah daftar
. Jika tidak, anda mungkin secara tidak sengaja menggunakan perkhidmatan daripada pembekal perkhidmatan yang belum dimuatkan. 🎜🎜Mari kita lihat penyedia perkhidmatan asas. Dalam mana-mana kaedah pembekal perkhidmatan, anda sentiasa mengakses bekas perkhidmatan melalui atribut $app
: 🎜<?php namespace App\Providers; use Illuminate\Support\ServiceProvider; class ComposerServiceProvider extends ServiceProvider{ /** * 启动所有的应用服务。 * * @return void */ public function boot() { view()->composer('view', function () { // }); } }🎜Bekas perkhidmatan ini hanya mentakrifkan kaedah
register
dan menggunakannya Kaedah ini mentakrifkan antara muka RiakConnection
dalam bekas perkhidmatan. Jika anda tidak memahami cara bekas perkhidmatan berfungsi, lihat dokumentasinya. 🎜Ciri binding
dan singleton
Jika pembekal perkhidmatan anda mendaftarkan banyak pengikatan mudah, anda mungkin mahu menggunakan bindings
dan singleton
dan bukannya mendaftarkan setiap bekas yang mengikat secara manual. Apabila pembekal perkhidmatan dimuatkan oleh rangka kerja, sifat ini disemak secara automatik dan pengikatan yang sepadan didaftarkan bindings
和 singletons
的特性
如果你的服务提供器注册了许多简单的绑定,你可能想用 bindings
和 singletons
属性替代手动注册每个容器绑定。当服务提供器被框架加载时,将自动检查这些属性并注册相应的绑定
use Illuminate\Contracts\Routing\ResponseFactory; public function boot(ResponseFactory $response){ $response->macro('caps', function ($value) { // }); }
引导方法
如果我们要在服务提供者中注册一个 视图合成器 该怎么做? 这就需要用到 boot
方法了。 该方法在所有服务提供者被注册以后才会被调用, 这就是说我们可以在其中访问框架已注册的所有其它服务:
'providers' => [ // 其他服务提供者 App\Providers\ComposerServiceProvider::class,],
启动方法的依赖注入
你可以为服务提供者的 boot
方法设置类型提示。 服务容器 会自动注入你所需要的依赖:
<?php namespace App\Providers; use Riak\Connection; use Illuminate\Support\ServiceProvider; use Illuminate\Contracts\Support\DeferrableProvider; class RiakServiceProvider extends ServiceProvider implements DeferrableProvider{ /** * 注册服务提供者。 * * @return void */ public function register() { $this->app->singleton(Connection::class, function ($app) { return new Connection($app['config']['riak']); }); } /** * 获取由提供者提供的服务。 * * @return array */ public function provides() { return [Connection::class]; } }
注册服务提供者
所有服务提供者都是通过配置文件 config/app.php
进行注册。该文件包含了一个列出所有服务提供者名字的 providers
数组,默认情况下,其中列出了所有核心服务提供者,这些服务提供者启动 Laravel 核心组件,比如邮件、队列、缓存等等。
要注册提供器,只需要将其添加到数组:
rrreee延迟提供者
如果你的服务提供者 只 在 服务容器 中注册,可以选择延迟加载该绑定直到注册绑定的服务真的需要时再加载,延迟加载这样的一个提供者将会提升应用的性能,因为它不会在每次请求时都从文件系统加载。
Laravel 编译并保存延迟服务提供者提供的所有服务的列表,以及其服务提供者类的名称。因此,只有当你在尝试解析其中一项服务时,Laravel 才会加载服务提供者。
要延迟加载提供者,需要实现 IlluminateContractsSupportDeferrableProvider
接口并置一个 provides
方法。这个 provides
rrreee
Kaedah but
< p >Bagaimana jika kita ingin mendaftarkan penggubah paparan dengan pembekal perkhidmatan? Ini memerlukan penggunaan kaedahboot
. Kaedah ini tidak akan dipanggil sehingga semua penyedia perkhidmatan didaftarkan, yang bermaksud bahawa kami boleh mengakses semua perkhidmatan lain yang didaftarkan oleh rangka kerja: rrreeeMulakan suntikan pergantungan kaedah Anda boleh tetapkan petunjuk jenis untuk kaedah boot
pembekal perkhidmatan. Bekas perkhidmatan akan secara automatik menyuntik kebergantungan yang anda perlukan:
Mendaftarkan pembekal perkhidmatan
Semua pembekal perkhidmatan dikonfigurasikan melalui Fail config/app.php
untuk mendaftar. Fail ini mengandungi tatasusunan penyedia
yang menyenaraikan nama semua penyedia perkhidmatan Secara lalai, semua penyedia perkhidmatan teras ini memulakan komponen teras Laravel, seperti mel dan baris gilir . 🎜
Untuk mendaftar pembekal, cuma tambahkannya pada tatasusunan: 🎜rrreee