Zum Inhalt springen
Dokumentation · Integrationen

Andere Frameworks und reines PHP

Jedes PHP-Framework oder keines: Ihr eigener Kernel und Behavior-Klassen, die ihre Abhängigkeiten aus einem PSR-11-Container beziehen.

Aus dem Englischen übersetzt. Maßgeblich ist die englische Seite. Original lesen

Ohne Bridge schreiben Sie den Kernel selbst und initialisieren ihn in Ihrem Front-Controller, wie unter Erste Schritte gezeigt. Um Behavior-Klassen (Verhaltensklassen) Zugriff auf die Services Ihrer Anwendung zu geben, binden Sie deren PSR-11-Container als Delegate an den Container des Kernels (AspectContainer) an:

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() und has() des Kernel-Containers greifen für IDs, die er nicht kennt, auf den Delegate zurück. Der Kernel wird initialisiert, bevor die Anwendung ihren Container baut, deshalb registrieren Sie Behavior-Klassen wie gewohnt, und sie lösen ihre Abhängigkeiten lazy auf. Der Compile-Step (Kompilierschritt) und das Cache-Warm-up brauchen nur die Behavior-Klasse selbst, sie laufen also vor setDelegate() und erzeugen nie eine Instanz davon. Eine Abhängigkeit, die beim Ausführen der Factory noch fehlt, wirft ServiceNotFoundException.

  • Eine Factory fragt den Container des Kernels nie nach ihrer eigenen ID: Diese ID löst auf die Behavior-Klasse auf, die gerade gebaut wird.
  • Behavior-Klassen werden im Delegate nie automatisch gefunden, weil sich ein PSR-11-Container nicht introspektieren lässt. Registrieren Sie jede Behavior-Klasse in configureAop(). Eine Bridge für ein bestimmtes Framework kann Services nach Tag oder Interface einsammeln und mit addLazyService() registrieren.
  • Das Erzeugen einer Behavior-Klasse darf keines ihrer eigenen Behaviors (Verhalten) auslösen. Der Interceptor meldet diesen Fall mit einer AspectCircularReferenceException.

Alle Kernel-Optionen, die Features-Flags und die vendor/bin/aspect-Befehle stehen unter Konfiguration & CLI. Das Rezept für das Deployment steht unter Produktion & Performance.

© 2026 Alexander Lisachenko