Aller au contenu
Documentation · Intégrations

Autres frameworks et PHP pur

N’importe quel framework PHP, ou aucun : votre propre noyau et des behavior classes qui tirent leurs dépendances d’un conteneur PSR-11.

Traduit de l’anglais. La page anglaise fait référence. Lire l’original

Sans bridge, vous écrivez vous-même le noyau (kernel) et l’initialisez dans votre contrôleur frontal, comme le montre Premiers pas. Pour donner aux behavior classes (classes de comportement) l’accès aux services de votre application, rattachez son conteneur PSR-11 comme délégué du conteneur du noyau (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() et has() du conteneur du noyau se replient sur le délégué pour les identifiants qu’il ne connaît pas. Le noyau est initialisé avant que l’application ne construise son conteneur : vous enregistrez donc les behavior classes comme d’habitude, et elles résolvent leurs dépendances de façon paresseuse. La compile step (étape de compilation) et le préchauffage du cache n’ont besoin que de la behavior class elle-même : ils s’exécutent donc avant setDelegate() et n’en créent jamais d’instance. Une dépendance encore manquante au moment où la factory s’exécute lève ServiceNotFoundException.

  • Une factory ne demande jamais son propre identifiant au conteneur du noyau : cet identifiant désigne la behavior class en cours de construction.
  • Les behavior classes ne sont jamais découvertes dans le délégué, car un conteneur PSR-11 ne peut pas être inspecté. Enregistrez chaque behavior class dans configureAop(). Un bridge propre à un framework peut collecter des services par tag ou par interface et les enregistrer avec addLazyService().
  • Créer une behavior class ne doit déclencher aucun de ses propres behaviors (comportements). L’intercepteur signale ce cas par une AspectCircularReferenceException.

Toutes les options du noyau, les drapeaux Features et les commandes vendor/bin/aspect sont dans Configuration et CLI. La procédure de déploiement est dans Production et performances.

© 2026 Alexander Lisachenko