サービスコンテナとサービスプロバイダーの要点

2022/11/19

サービスコンテナとサービスプロバイダーの要点についてまとめてます。バインド、解決、依存注入(DI)など理解が難しいかもしれませんが、Laravelの根幹を成す機能なので、動作確認などしながら理解するのをおすすめします。

サービスコンテナ

クラス(サービス)のインスタンス化を管理します。

Illuminate\Container\Containerクラス を継承した
Illuminate\Foundation\Applicationクラス によって実装されています。

インジェクトするクラスを簡単に変更できるので、テストでモックに差し替えたいときなどに便利です。

サービスコンテナへインスタンス生成方法を結びつけることをバインドと言います。
下記メソッドでバインドできます。

以下ケースで活躍します。

インターフェースに複数の具象クラスが紐づく時、Aクラスのときには、具象クラスAを利用、Bクラスのときには、具象クラスBを利用といった使い方もできます。

インターフェースに依存してないクラスは、リフレクションで解決するのでバインドの必要はありません。

サービスコンテナに要求して、インスタンスを取得することを解決と言います。
「Applicationクラスのmakeメソッド」「resolveヘルパー」などで解決できます。
解決するクラスで、コンストラクタの引数を必要としている場合、ApplicationクラスのmakeWithメソッドを利用できます(5.4~)。
- ただし、モックには差し替えられません。

コントローラ、イベントリスナ、キュージョブ、ミドルウェアなどについては、タイプヒントで指定すると、サービスコンテナが自動的に解決してくれます。

「コンストラクションインジェクション」と「メソッドインジェクション」が可能です。

タイプヒントには、インターフェイスと具象クラスを指定できます。
インターフェイスを指定した場合、コンテナに具象クラスを結合する必要があります。

詳しくは、下記サイトで確認できます。
⇒ http://readouble.com/laravel/5.5/ja/container.html

サービスプロバイダーの要点は以下の通りです。

config/app.phpのproviders配列にサービスプロバイダーを設定する。
サービスプロバイダーは、初期起動時にロードされる。
- まず全プロバイダーのregisterメソッドが呼び出される。
- 次に全プロバイダーのbootメソッドが呼び出される。
registerメソッドでサービスコンテナにバインドする。
$deferプロパティをtrueにすると、遅延登録ができる。