DI
依存性の注入(Dependency Injection)とはクラスが必要とするサービスや値などのインスタンス(依存性)を、 サービス自身が取得したり生成するのではなく外部から渡す(注入)デザインパターンのことです。
Ray.DiはGoogleのGuiceの主要な機能を持つPHPのDIフレームワークでBEAR.SundayはDIにRay.Diを使っています。
概要
Ray.Diには以下の機能があります。
-
コンストラクタインジェクションとセッターインジェクション
-
自動インジェクション
-
コンストラクタの後の初期化メソッド指定(
@PostConstruct
) -
高速化のためPHPのファクトリーコード生成
-
名前付きインターフェイス
-
インジェクションポイントメタデータ
-
アノテーション(Doctrine Annotation)はオプション
注入
クラスが依存を受け取る箇所はコンストラクタ、セッターメソッド、実行メソッドの三種類がありそれをインジェクションポイントと呼びます。
コンストラクタでの注入は必須でアノテーションは不要ですが、セッターメソッドには通常のメソッドと区別するための@Inject
アノテーションが必要です。
コンストラクターインジェクション
use Ray\Di\Di\Inject;
class Index
{
private $logger;
public function __construct(LoggerInterface $logger)
{
$this->logger = $logger;
}
セッターインジェクション
use Ray\Di\Di\Inject;
class Index
{
private $logger;
/**
* @Inject
*/
public function setLogger(LoggerInterface $logger)
{
$this->logger = $logger;
}
アシスティッドインジェクション
use Ray\Di\Di\Assisted;
class Index
{
/**
* @Assisted({"logger"})
*/
public function doSomething(LoggerInterface $logger = null)
{
$logger->log('log message..');
}
束縛
インジェクタの仕事はオブジェクトグラフを作成することです。 型を指定してインスタンスを要求し、依存関係を解決し、すべてを結びつけます。 依存関係の解決方法を指定するにはバインディングを設定します。
オブジェクトグラフとは? |
オブジェクト指向のアプリケーションは相互に関係のある複雑なオブジェクト網を持ちます。オブジェクトはあるオブジェクトから所有されているか、他のオブジェクト(またはそのリファレンス)を含んでいるか、そのどちらかでお互いに接続されています。このオブジェクト網をオブジェクトグラフと呼びます。 |
束縛作成
束縛を作るにはAbstractModule
クラスを拡張して、configure
メソッドをオーバーライドします。メソッド内ではbind()
でそれぞれの束縛をします。
class Tweet extends AbstractModule
{
protected function configure()
{
$this->bind(TweetClient::class);
$this->bind(TweeterInterface::class)->to(SmsTweeter::class)->in(Scope::SINGLETON);
$this->bind(UrlShortenerInterface::class)->toProvider(TinyUrlShortener::class);
$this->bind('')->annotatedWith(Username::class)->toInstance("koriym");
}
}
モジュールでは以下のいずれかの束縛を行います。
- リンク束縛
$this->bind($interface)->to($class);
- 名前付き束縛
$this->bind($interface)->annotatedWith($name)->to($class);
- コンストラクタ束縛
$this->bind($interface)->toConstructor($class, [$varName => $name]);
- アンターゲット束縛
$this->bind($class);
- プロバイダー束縛
$this->bind($interface)->toProvider($provider);
- インスタンス束縛
$this->bind($interface)->toInstance($instance);
リンク束縛
リンク束縛は最も基本の束縛です。インターフェイスとその実装クラスを束縛します。
class ListerModule extends AbstractModule
{
public function configure()
{
$this->bind(LoggerInterface::class)->to(Logger::class);
}
}
名前付き束縛
1つのインターフェイスに複数の実装クラスがあったり、インターフェイスを持たないスカラータイプの依存の場合に依存に名前をつけて束縛します。
class ListerModule extends AbstractModule
{
public function configure()
{
$this->bind(LoggerInterface::class)->annotatedWith('prod')->to(Logger::class);
$this->bind(LoggerInterface::class)->annotatedWith('dev')->to(Logger::class);
}
}
名前付き束縛で束縛した依存は@Named
アノテーションで指定して受け取ります。
use Ray\Di\Di\Inject;
use Ray\Di\Di\Named;
class Index
{
private $logger;
/**
* @Inject
* @Named("prod")
*/
public function setLogger(LoggerInterface $logger)
{
$this->logger = $logger;
}
定数の代わりにアノテーションにすることもできます。
/**
* @Annotation
* @Target("METHOD")
*/
final class Prod
{
}
$this->bind(LoggerInterface::class)->annotatedWith(Prod::class)->to(Logger::class);
use Ray\Di\Di\Inject;
use Ray\Di\Di\Named;
class Index
{
private $logger;
/**
* @Inject
* @Prod
*/
public function setLogger(LoggerInterface $logger)
{
$this->logger = $logger;
}
引数が複数の場合は変数名=名前
のペアでカンマ区切りの文字列を指定します。
/**
* @Named("paymentLogger=payment_logger,debugLogger=debug_logger")
*/
public __construct(LoggerInterface $paymentLogger, LoggerInterface $debugLogger)
{
アンターゲット束縛
インターフェイスなしのクラスの束縛に使います。
protected function configure()
{
$this->bind(MyConcreteClass::class);
$this->bind(AnotherConcreteClass::class)->in(Scope::SINGLETON);
}
リソースクラスは全てアンターゲット束縛されていて使用しないリソースでも依存解決に問題があるとエラーになります。
コンストラクタ束縛
アノテーションを使わない場合や、セッターメソッドに@Inject
アノテーションのないサードパーティーのクラスなどはコンストラクタ束縛で束縛することができます。(コンストラクトインジェクションと混同しないように注意)
最初の引数にはクラス名前、2番目の引数の変数名
=>名前
の名前束縛、3番目の引数にセッターインジェクションを指定します。
<?php
class WebApi implements WebApiInterface
{
private $id;
private $password;
private $client;
private $token;
/**
* @Named("id=user_id,password=user_password")
*/
public function __construct(string $id, string $password)
{
$this->id = $id;
$this->password = $password;
}
/**
* @Inject
*/
public function setGuzzle(ClientInterface $client)
{
$this->client = $client;
}
/**
* @Inject(optional=true)
* @Named("token")
*/
public function setOptionalToken(string $token)
{
$this->token = $token;
}
/**
* @PostConstruct
*/
public function initialize()
{
}
上記のWebApiクラスをアノテーションなしでWebApiInterfaceにコンストラクタ束縛する場合は以下のようになります。
<?php
protected function configure()
{
$this
->bind(WebApiInterface::class)
->toConstructor(
WebApi::class, // string $class_name
[
['id' => 'user_id'], // array $name
['password' => 'user_password']
],
(new InjectionPoints) // InjectionPoints $setter_injection
->addMethod('setGuzzle', 'token')
->addOptionalMethod('setOptionalToken'),
'initialize' // string $postConstruct
);
$this->bind()->annotatedWith('user_id')->toInstance($_ENV['user_id']);
$this->bind()->annotatedWith('user_password')->toInstance($_ENV['user_password']);
}
PDO Example
PDOクラスの束縛の例です.
PDOクラスにはアノテーションが無い為に、$username
と$password
に名前をつけて束縛しています。
public PDO::__construct ( string $dsn [, string $username [, string $password [, array $options ]]] )
protected function configure()
{
$this->bind(\PDO::class)->toConstructor(
\PDO::class,
[
['pdo' => 'pdo_dsn'],
['username' => 'pdo_username'],
['password' => 'pdo_password']
]
)->in(Scope::SINGLETON);
$this->bind()->annotatedWith('pdo_dsn')->toInstance($dsn);
$this->bind()->annotatedWith('pdo_username')->toInstance($username);
$this->bind()->annotatedWith('pdo_password')->toInstance($password);
}
PDOのインターフェイスがないのでtoConstructor()
メソッドの二番目の引数の名前束縛で束縛しています。
プロバイダ束縛
インターフェイスとインスタンスのプロバイダーを束縛します。
プロバイダーは依存のファクトリーです。get
メソッドで依存を返します。
use Ray\Di\ProviderInterface;
interface ProviderInterface
{
public function get();
}
プロバイダーにも依存は注入できます。
use Ray\Di\ProviderInterface;
class DatabaseTransactionLogProvider implements Provider
{
private $pdo;
/**
* @Named("original")
*/
public function __construct(\PDO $pdo)
{
$this->pdo = $pdo;
}
public function get()
{
$this->pdo->setAttribute(\PDO::ATTR_CASE, \PDO::CASE_NATURAL);
return $this->pdo;
}
}
注意:get()内でnew
して生成したインスタンスはAOPできません。この束縛は他の束縛でできない時にのみするべきです。
コンテキストプロバイダ束縛
同じプロバイダーでコンテキスト別にオブジェクトを生成したい場合があります。例えば接続先の違う複数のDBオブジェクトを同じインターフェイスでインジェクトしたい場合などです。そういう場合にはtoProvider()
でコンテキスト(文字列)を指定して束縛をします。
$dbConfig = ['user' => $userDsn, 'job' => $jobDsn, 'log' => $logDsn];
$this->bind()->annotatedWith('db_config')->toInstance($dbConfig);
$this->bind(Connection::class)->annotatedWith('usr_db')->toProvider(DbalProvider::class, 'user');
$this->bind(Connection::class)->annotatedWith('job_db')->toProvider(DbalProvider::class, 'job');
$this->bind(Connection::class)->annotatedWith('log_db')->toProvider(DbalProvider::class, 'log');
プロバイダーはコンテキスト別に生成します。
class DbalProvider implements ProviderInterface, SetContextInterface
{
private $dbConfigs;
private $context;
/**
* @Named("db_config")
*/
public function __construct(array $dbConfigs)
{
$this->dbConfigs = $dbConfigs;
}
public function setContext($context)
{
$this->context = $context;
}
/**
* {@inheritdoc}
*/
public function get()
{
$config = $this->dbConfigs[$this->context];
$conn = DriverManager::getConnection($config);
return $conn;
}
}
同じインターフェイスですが、接続先の違う別々のDBオブジェクトを受け取ります。
/**
* @Named("userDb=user_db,jobDb=job_db,logDb=log_db")
*/
public function __construct(Connection $userDb, Connection $jobDb, Connection $logDb)
{
//...
}
インジェクションポイント
プロバイダではInjectionPointInterface
で依存が注入されるインジェクションポイントの情報を受け取ることができます。
この例ではLogger
の引数の最初に「注入先のクラス名」を指定しています。
class Psr3LoggerProvider implements ProviderInterface
{
/**
* @var InjectionPoint
*/
private $ip;
public function __construct(InjectionPointInterface $ip)
{
$this->ip = $ip;
}
/**
* @return Logger
*/
public function get()
{
$targetClass = $this->ip->getClass()->getName();
$logger = new \Monolog\Logger($targetClass);
$logger->pushHandler(new StreamHandler('path/to/your.log', Logger::WARNING));
return $logger;
}
}
InjectionPointInterface
は以下のメソッドがありインジェクション先のアノテーションを読むこともできます。
インジェクションポイントに応じたインスタンスを用意することができます。
$ip->getClass(); // \ReflectionClass
$ip->getMethod(); // \ReflectionMethod
$ip->getParameter(); // \ReflectionParameter
$ip->getQualifiers(); // (array) $qualifierAnnotations[]
インスタンス束縛
toInstance()
で値を直接束縛します。定数の束縛に使います。
protected function configure()
{
$this->bind()->annotatedWith("message")->toInstance('Hello');
}
定数をまとめて束縛する時はNamedModule
を使います。
protected function configure()
{
$names = [
'lang' => 'ja',
'message' => 'こんにちは'
];
$this->install(new NamedModule($names));
}
/**
* @Named("message")
*/
public function setMessage(string $message) // こんにちは
{
オブジェクトも束縛できますが、単純な値オブジェクトだけにするべきです。 サービスオブジェクトには使わないようにします。
protected function configure()
{
$this->bind(UserInterface::class)->toInstance(new User); // シリアライズして保存されます
}
オブジェクトライフサイクル
@PostConstruct
でアノテートしたメソッドはコンストラクタインジェクション、セッターインジェクションが全て完了した後に呼ばれます。
依存注入後の初期化に使用します。
ある場合などでも全ての必要な依存が注入された前提にすることができます。
use Ray\Di\Di\PostConstruct;
/**
* @PostConstruct
*/
public function onInit()
{
//....
}
まとめ:メソッドは以下の順番で呼ばれます。
- コンストラクタ
- セッターメソッド(順不同)
@PostConstruct
メソッド- デストラクタ
スコープ
デフォルトでは、Rayは毎回新しいインスタンスを生成します(=プロトタイプ)がシングルトンに変更するにはin
で指定します。
use Ray\Di\Scope;
protected function configure()
{
$this->bind(TransactionLog::class)->to(InMemoryTransactionLog::class)->in(Scope::SINGLETON);
}
アシスティッドインジェクション
メソッドが実行されるタイミングでメソッドの引数に依存を渡すことができます。そのためには依存を受け取る引数を@Assisted
で指定し、引数リストの終わり(右)に移動してnull
をディフォルトとして与える必要があります。
use Ray\Di\Di\Assisted;
class Index
{
/**
* @Assisted({"db"})
*/
public function doSomething($id, DbInterface $db = null)
{
$this->db = $db;
}
@Assisted
で提供される依存は、その時に渡された他の引数を参照して決定することもできます。そのためには依存をプロバイダーバインディング
で束縛して、そのプロバイダー束縛はMethodInvocationProvider
を依存として受け取るようにします。get()
メソッドでメソッド実行オブジェクト MethodInvocation を取得することができ、引数の値や対象のメソッドのプロパティにアクセスすることができます。
class HorizontalScaleDbProvider implements ProviderInterface
{
/**
* @var MethodInvocationProvider
*/
private $invocationProvider;
public function __construct(MethodInvocationProvider $invocationProvider)
{
$this->invocationProvider = $invocationProvider;
}
public function get()
{
$methodInvocation = $this->invocationProvider->get();
list($id) = methodInvocation->getArguments()->getArrayCopy();
return new UserDb($id); // $idによって接続データベースを切り替えます
}
}
デバッグ
複雑な束縛も最終的には単純なPHPのファクトリーコードにコンパイルされてvar/tmp/{context}
フォルダに出力されます。
生成されたファイルを見ればどのセッターメソッドが有効でどの依存をどのように(Singleton ?)注入したかが分かります。
ファイル名は{インターフェイス}-{名前}
で中身はこのようなコードです。
<?php
$instance = new \MyVendor_Todo_Resource_App_Todos_c0kmGJA();
$instance->setRenderer($singleton('BEAR\\Resource\\RenderInterface-'));
$instance->setAuraSql($singleton('Aura\\Sql\\ExtendedPdoInterface-'));
$instance->setQueryLocator($prototype('Koriym\\QueryLocator\\QueryLocatorInterface-'));
$instance->bindings = array('onGet' => array($singleton('BEAR\\Resource\\Interceptor\\JsonSchemaInterceptor-')));
return $instance;
MyVendor_Todo_Resource_App_Todos_c0kmGJA
という語尾に文字列がつく生成されたクラス名はAOPがバインドされていることを表します。$singleton('BEAR\\Resource\\RenderInterface-')
はRenderInterface
インターフェイスに束縛されてあるインスタンスをシングルトンで取得するという意味です。$instance->bindings
の[{メソッド名} => {インターセプター}]
の配列がインターセプターの束縛を表します。
demo
Ray.Diを更に理解するためにdemoコード
もご覧ください。様々なタイプの束縛の例があります。