コンテンツにスキップ
ドキュメント · インテグレーション

その他のフレームワークと素の PHP

どんな PHP フレームワークでも、フレームワークなしでも:独自のカーネルと、PSR-11 コンテナから依存関係を受け取る behavior class。

このページは英語版からの翻訳です。基準となるのは英語版のページです。 原文を読む

ブリッジを使わない場合は、はじめにで示したとおり、カーネルを自分で書いてフロントコントローラーで初期化します。behavior class(振る舞いクラス)からアプリケーションのサービスを使えるようにするには、アプリケーションの PSR-11 コンテナを、カーネルのコンテナ(AspectContainer)のデリゲートとして接続します。

app/ApplicationAspectKernel.php
protected function configureAop(AspectContainer $container): void
{
// Runs when one of its behaviors first runs, after the application container is attached
$container->addLazyService(
MonitorAspect::class,
static fn(AspectContainer $container) => new MonitorAspect($container->getService(LoggerInterface::class)),
);
// or take the whole behavior class from the application container, by the id it has there
// $container->addLazyService(MonitorAspect::class, static fn(AspectContainer $c) => $c->get('app.monitor_aspect'));
}
// Once the application container exists, e.g. right after the framework kernel has booted
ApplicationAspectKernel::getInstance()->getContainer()->setDelegate($psrContainer);

カーネルのコンテナの get()、getService()、has() は、自身が知らない ID についてデリゲートにフォールバックします。カーネルはアプリケーションがコンテナを構築する前に初期化されるので、behavior class はいつもどおりに登録し、依存関係は遅延して解決されます。compile step(コンパイルステップ)とキャッシュのウォームアップに必要なのは behavior class そのものだけなので、これらは setDelegate() より前に実行され、behavior class のインスタンスを生成することはありません。ファクトリの実行時にまだ依存関係が見つからなければ、ServiceNotFoundException が投げられます。

  • ファクトリは、カーネルのコンテナに自分自身の ID を問い合わせてはなりません。その ID は、今まさに構築中の behavior class に解決されます。
  • PSR-11 コンテナは内部を調べることができないため、behavior class がデリゲートから自動で検出されることはありません。すべての behavior class を configureAop() で登録してください。特定のフレームワーク向けのブリッジなら、タグやインターフェースでサービスを集め、addLazyService() で登録できます。
  • behavior class の生成で、そのクラス自身の behavior(振る舞い)が実行されてはなりません。インターセプターはその場合を AspectCircularReferenceException で報告します。

カーネルのすべてのオプション、Features フラグ、vendor/bin/aspect のコマンドは設定と CLI にあります。デプロイの手順は本番環境とパフォーマンスにあります。

© 2026 Alexander Lisachenko