Laravelの構成概念 第2回 サービスコンテナ編
はじめに
前回のライフサイクル編の続きとして、今回はサービスコンテナのご紹介をします。
シリーズ
- Laravelの構成概念 第1回 ライフサイクル編
- Laravelの構成概念 第2回 サービスコンテナ編
- Laravelの構成概念 第3回 サービスプロバイダ編
環境
- Laravel 8.5.11
参考
- Laravel 8.x ライフサイクル
- Laravel 8.x サービスコンテナ
- Laravel 8.x サービスプロバイダ
-
Laravel 8.x ファサード
- (今回はあまり触れません)
- Laravel API 8.x
- Laravel フレームワーク
- Laravel コアフレームワーク
Laravelの構成概念については公式ドキュメントにより詳しい内容がまとまっているので詳細を知りたい方は上記の公式ドキュメントをご覧ください。
Laravel サービスコンテナとは
Laravelのサービスコンテナはクラスの依存関係を管理し、依存注入(DI)を実行するための機能です。
イメージとしては、サービス(クラス)を入れておく箱のイメージです。
サービスコンテナは結合と依存解決という二つの機能があります。
- 結合: サービスコンテナにクラスを登録する
- 依存解決: サービスコンテナに登録されたクラスのインスタンスを取り出す
DI(Dependency Injection)とは
Dependency Injectionは依存性の注入となります。
抽象クラス(interface)を具象クラスに差し替えて実行できる。
要するにクラスのインスタンス生成処理をサービスコンテナに任せて、クラスの疎結合に保つ仕組みです。
疎結合になっていることでテストの時はDBや外部APIを実際に叩かせないように、プログラム実行時にクラスを差し替えできる。
なかなか簡潔に説明するのは難しく、詳細はDI関連のオススメ記事を抜粋したので読んだり、ご自身で調べてみてください。
DIの種類
- コンストラクタインジェクション
- メソッドインジェクション(セッターインジェクション)
- フィールドインジェクション(プロパティインジェクション)
- PHPでは標準実装されていない
DIの種類は3つありますが、コンストラクタインジェクションだけで十分なので覚えておきましょう。
Laravelのフレームワーク内で実行されるコントローラのルーティングに対応しているメソッドやコンソールコマンドのhandle()
メソッドであればメソッドインジェクションを利用できます。(Request
クラスなどよく使われます)
結合: サービスコンテナにクラスを登録する
結合とはサービスコンテナにインターフェースに対応するクラスを登録することです。
登録自体は次章のサービスプロバイダを使って登録します。
- bind
- singleton
- instance
大きく3種類ありますが、特に理由がない限りはbindで結合します。
他にもコンテキストによる結合、プリミティブの結合、型指定した可変引数の結合、タグ付け、結合の拡張等ありますが、必要に迫られたら検討してみてください。
bind(バインド、シンプルな結合)
インターフェース名に対応するクラスを登録する。
サービスコンテナから取り出すときに毎回新しいインスタンスを生成する。
singleton(シングルトンの結合)
インターフェース名に対応するクラスを登録する。
サービスコンテナから初めて取り出すときに新しいインスタンスを生成する。
2回目以降に取り出す時は初回に生成された同じインスタンスが返る。(要は同じインスタンスを使い回しする)
ライフサイクルの記事では、bootstrap/app.php
でKernel
クラスがシングルトン結合されてましたね。
instance(インスタンスの結合)
インターフェース名に対応するインスタンスを登録する。
予め生成したインスタンスをサービスコンテナに登録します。
取り出す時は登録時のインスタンスが返ります。
依存解決: サービスコンテナに登録されたクラスのインスタンスを取り出す
依存解決は結合とは反対にサービスコンテナに登録したクラスのインスタンスを取り出すことです。
make
メソッドを利用して取り出すパターンと自動注入(DI)
を利用して取り出すパターンがあります。
特に理由がない限りは 自動注入(DI)
を使って取り出します。
自動注入(DI)
基本はコンストラクタインジェクションを利用します。
Laravelではメソッドインジェクションやルートモデル結合といった便利機能がありますが、やはりコンストラクタインジェクションだけで良いかなと思います。
さいごに
以上でサービスコンテナ編は終了です。
サービスコンテナは難しいと抵抗あるかもしれませんが、クラスを登録して取り出すという実はシンプルな機能です。
次回はサービスプロバイダーの記事です。お楽しみに!
Author And Source
この問題について(Laravelの構成概念 第2回 サービスコンテナ編), 我々は、より多くの情報をここで見つけました https://qiita.com/ucan-lab/items/6f354cf6ae5e807dbada著者帰属:元の著者の情報は、元のURLに含まれています。著作権は原作者に属する。
Content is automatically searched and collected through network algorithms . If there is a violation . Please contact us . We will adjust (correct author information ,or delete content ) as soon as possible .