Перейти к содержимому
Документация · Интеграции

Другие фреймворки и чистый PHP

Любой PHP-фреймворк или вовсе без него: собственное ядро и классы поведений, которые получают зависимости из PSR-11-контейнера.

Перевод с английского. Эталоном считается английская версия страницы. Читать оригинал

Без моста (bridge) вы пишете ядро сами и инициализируете его во фронт-контроллере, как показано на странице Начало работы. Чтобы дать behavior classes (классам поведений) доступ к сервисам приложения, подключите его 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() обращаются к делегату. Ядро инициализируется раньше, чем приложение собирает свой контейнер, поэтому вы регистрируете behavior classes как обычно, а свои зависимости они получают лениво. Compile step (этап компиляции) и прогрев кеша требуют только сам behavior class, поэтому выполняются до setDelegate() и никогда не создают его экземпляр. Если к моменту запуска фабрики зависимости всё ещё нет, выбрасывается ServiceNotFoundException.

  • Фабрика никогда не запрашивает у контейнера ядра собственный идентификатор: он указывает на тот самый behavior class, который сейчас создаётся.
  • Behavior classes никогда не обнаруживаются в делегате, потому что PSR-11-контейнер невозможно исследовать. Регистрируйте каждый behavior class в configureAop(). Мост для конкретного фреймворка может собирать сервисы по тегу или интерфейсу и регистрировать их через addLazyService().
  • Создание behavior class не должно запускать его собственные behaviors (поведения). Этот случай перехватчик сообщает исключением AspectCircularReferenceException.

Все параметры ядра, флаги Features и команды vendor/bin/aspect описаны на странице Конфигурация и CLI. Рецепт деплоя — на странице Продакшен и производительность.

© 2026 Alexander Lisachenko