Yii3
Integración con Yii3 mediante goaop/goaop-yii3-bridge 1.0: conexión con yiisoft/config, behavior classes etiquetadas y ./yii aop:warmup.
Traducido del inglés. La página en inglés es la referencia. Leer el original
El bridge goaop/goaop-yii3-bridge 1.0 se conecta a yiisoft/config. Tus behavior classes (clases de comportamiento) son servicios normales del contenedor de Yii, y el motor resuelve cada una solo cuando uno de sus behaviors (comportamientos) se ejecuta por primera vez.
Requisitos
Sección titulada «Requisitos»- PHP 8.4 o posterior
- Paquetes de Yii3: yiisoft/config, yiisoft/di, yiisoft/aliases (como en la plantilla de aplicación)
goaop/framework^4.0 (behaviors declarados con atributos)
Instalación
Sección titulada «Instalación»composer require goaop/goaop-yii3-bridgeEl plugin de yiisoft/config recoge la configuración del bridge. Si lo instalaste con el plugin desactivado, ejecuta composer yii-config-rebuild.
Arrancar el kernel desde el script de entrada
Sección titulada «Arrancar el kernel desde el script de entrada»use App\Environment;use Go\Yii3\GoAopBridge\AopBootstrap;use Yiisoft\Yii\Runner\Http\HttpApplicationRunner;
// ...
$runner = new HttpApplicationRunner( rootPath: dirname(__DIR__), debug: Environment::appDebug(), checkEvents: Environment::appDebug(), environment: Environment::appEnv(),);
AopBootstrap::init($runner->getConfig(), rootPath: dirname(__DIR__));
$runner->run();Añade la línea AopBootstrap::init() a cada script de entrada, entre la creación del runner y su ejecución: public/index.php, yii (con su ConsoleApplicationRunner y rootPath: __DIR__) y el bootstrap de tus tests funcionales. Lee los parámetros del bridge y los alias de la configuración del runner. El runner conserva esa configuración, así que los parámetros no se construyen dos veces.
El compile step (paso de compilación) solo se aplica a las clases cargadas después de que arranque el kernel, y el runner de Yii autocarga clases mientras construye el contenedor. Si omites esta línea, el grupo de configuración bootstrap del bridge sigue arrancando el kernel, pero tarde: las clases cargadas mientras se construía el contenedor no se compilan. En modo debug eso incluye cada clase con una definición en forma de array, así que la aplicación se comportaría de forma distinta en desarrollo y en producción.
Definir y registrar behavior classes
Sección titulada «Definir y registrar behavior classes»<?php
declare(strict_types=1);
namespace App\Aspect;
use Go\Aop\Aspect;use Go\Aop\Intercept\MethodInvocation;use Go\Lang\Attribute\Around;use Go\Lang\Attribute\Before;use Psr\Log\LoggerInterface;
final readonly class LoggingAspect implements Aspect{ public function __construct(private LoggerInterface $logger) {}
#[Before('execution(public App\Service\**->*(*))')] public function logCall(MethodInvocation $invocation): void { $this->logger->debug('Calling {method}', ['method' => $invocation->getMethod()->getName()]); }
#[Around('execution(public App\Service\PaymentService->charge(*))')] public function measureCharge(MethodInvocation $invocation): mixed { $start = hrtime(true); try { return $invocation->proceed(); } finally { $this->logger->info('charge() took {ms}ms', ['ms' => (hrtime(true) - $start) / 1e6]); } }}Enumera las behavior classes en el parámetro aspects:
'goaop/goaop-yii3-bridge' => [ 'aspects' => [ App\Aspect\LoggingAspect::class, App\Aspect\AuditAspect::class, ],],Los argumentos del constructor que no se pueden resolver con autowiring vienen de una definición del contenedor, como para cualquier otro servicio:
use App\Aspect\AuditAspect;use Yiisoft\Definitions\Reference;
return [ AuditAspect::class => [ '__construct()' => [ 'logger' => Reference::to('auditLogger'), 'level' => $params['app']['auditLevel'], ], ],];Cómo se resuelve una behavior class:
- Al arrancar el kernel no se autocarga nada: los nombres de clase solo se validan sintácticamente.
- Cuando el compilador necesita los behaviors de una clase, los lee de la clase mediante reflexión. El objeto de la behavior class es un lazy proxy nativo y todavía no se ha construido.
- En la primera llamada a uno de sus behaviors, el proxy se inicializa con
$container->get(AspectClass::class), la instancia compartida del contenedor de Yii.
Una behavior class que depende de una conexión a base de datos o de un cliente HTTP no la crea en las peticiones que nunca llegan a un método con un behavior. En modo debug, el bridge comprueba que cada clase de la lista existe e implementa Go\Aop\Aspect.
Un paquete puede aportar behavior classes desde su propio config/params.php. El grupo params se fusiona de forma recursiva, las listas se concatenan y los duplicados se registran una sola vez:
return [ 'goaop/goaop-yii3-bridge' => [ 'aspects' => [ Vendor\Package\Aspect\CacheAspect::class, ], ],];Etiquetar behavior classes (opcional)
Sección titulada «Etiquetar behavior classes (opcional)»Configura 'aspectTag' => 'goaop.aspect'. Después etiqueta las definiciones del grupo de configuración común di ('tags' => ['goaop.aspect']), o enuméralas en un mapa de etiquetas común di-tags (['goaop.aspect' => [LoggingAspect::class]]). Los servicios etiquetados deben registrarse con su nombre de clase.
La búsqueda está desactivada por defecto por su coste. El bridge lee las declaraciones de etiquetas de los archivos de configuración antes de que arranque el kernel, así que cada clase a la que hacen referencia esos archivos (con una constante de clase o un caso de enum, por ejemplo) se carga en ese momento y ya no se puede compilar. Solo se leen los grupos comunes. Las etiquetas de las definiciones di-web/di-console, los mapas di-tags-web/di-tags-console y los service providers no se ven.
Configuración
Sección titulada «Configuración»Los valores por defecto viven en el grupo params del bridge. Sobrescríbelos en config/common/params.php, o por entorno en config/environments/<env>/params.php.
| Parámetro | Valor por defecto | Propósito |
|---|---|---|
debug |
null |
Recompilar cuando cambian los fuentes o las behavior classes. null sigue a GOAOP_DEBUG y después a APP_DEBUG. Mantenlo desactivado en producción. |
appDir |
'@root' |
Raíz de la aplicación; solo se compilan los archivos que están por debajo. |
cacheDir |
null |
Fuentes compilados, proxies y cachés de advisors. null sigue a GOAOP_CACHE_DIR (admite un alias) y después a '@runtime/aop'. |
cacheFileMode |
null |
Permisos de los archivos de la caché: un entero (0770) o dígitos octales ('770'). null significa 0770 menos la umask. |
features |
0 |
Máscara de bits de flags de Go\Aop\Features: PREBUILT_CACHE, PARTIAL_REFLECTION, INTERCEPT_INCLUDES. |
includePaths |
['@src'] |
Solo se compilan estos directorios. Mantenlo acotado. |
excludePaths |
[] |
Nunca se compilan. El directorio de la caché y el framework siempre se excluyen. |
parsedFilesLimit |
null |
Archivos analizados que se mantienen en memoria durante la compilación; también es el valor por defecto de aop:warmup --cached-files. null significa el valor por defecto del kernel (100). |
aspects |
[] |
Behavior classes, resueltas de forma lazy desde el contenedor de Yii. |
aspectTag |
null |
Etiqueta de contenedor opcional que registra behavior classes, p. ej. 'goaop.aspect'. |
Un parámetro mal formado falla de inmediato con un mensaje que lo nombra. El kernel está disponible en el contenedor como Go\Core\AspectKernel (y Go\Yii3\GoAopBridge\Kernel\AspectYii3Kernel), y su contenedor como Go\Core\AspectContainer. Una vez ejecutado el callback bootstrap, el contenedor del kernel delega los ids desconocidos en el contenedor de Yii.
Comandos de consola
Sección titulada «Comandos de consola»Con yiisoft/yii-console instalado, el bridge añade estos comandos a ./yii:
| Comando | Propósito |
|---|---|
./yii aop:warmup |
Compila en la caché cada clase bajo las include paths. --fail-fast, --workers=N, --cache-dir=DIR, --preload[=FILE], --cached-files=N. |
./yii aop:opcache |
Puebla la caché de archivos de OPcache con la caché del framework, la aplicación y su configuración, después de aop:warmup. |
./yii aop:debug:aspect |
Lista las behavior classes con sus matching rules (reglas de coincidencia) y sus advisors (--aspect=... para una sola). |
./yii aop:debug:advisor |
Lista los advisors, o lo que selecciona un advisor (--advisor=...). |
./yii aop:debug:weaving |
Compila dos veces e informa de los proxies que difieren, lo que revela dependencias circulares entre behavior classes y clases compiladas. |
Son los comandos propios del framework, registrados en el namespace aop. Se ejecutan sobre el kernel que inicializó la línea de entrada, así que omite su argumento opcional loader. Los workers de --workers=N vuelven a ejecutar ./yii y necesitan la línea de entrada. Cuando fue el fallback bootstrap el que arrancó el kernel, el comando compila en su propio proceso y lo indica.
Despliegue
Sección titulada «Despliegue»./yii aop:warmup --workers=4En producción, desactiva debug y construye la caché en el despliegue. --cache-dir=DIR construye la caché en otro directorio mientras el kernel sigue usando el suyo. Los archivos de la caché son independientes de la ubicación, así que puedes mover el directorio a su sitio.
ENV GOAOP_CACHE_DIR=/app/aopRUN ./yii aop:warmup --workers=4 --preloadEn sistemas de archivos de solo lectura, añade Features::PREBUILT_CACHE a features. El motor confía entonces por completo en la caché y nunca escribe en ella, así que reconstrúyela en cada despliegue. Una clase bajo las include paths que la caché no conoce falla con una Go\Aop\Exception\WeavingException. El propio proceso aop:warmup queda exento, para que pueda compilar esas clases en la caché.
Con OPcache, ./yii aop:warmup --preload escribe _preload.php en el directorio de la caché para opcache.preload, y ./yii aop:opcache puebla la caché de archivos en la imagen final:
mkdir -p /var/cache/opcache && php -d opcache.enable_cli=1 -d opcache.file_cache_only=1 \ -d opcache.file_cache=/var/cache/opcache \ ./yii aop:opcache --file-cache=/var/cache/opcacheAdvertencias
Sección titulada «Advertencias»- Solo se compilan las clases bajo
appDireincludePaths. El código de vendor no. - Las clases cargadas antes de
AopBootstrap::init(), comoApp\Environment, no se pueden compilar. Tampoco las clases que la configuración carga mientras la línea de entrada la lee. - Las behavior classes no necesitan compilarse: excluye su directorio, p. ej.
'excludePaths' => ['@src/Aspect']. - Cuando crear una behavior class ejecuta uno de sus propios behaviors, ese behavior falla con una
Go\Aop\Exception\AspectCircularReferenceException. Inyecta esa dependencia de forma lazy (un closure oPsr\Container\ContainerInterface), o acota la matching rule. - El kernel es global al proceso. Los workers de larga duración (RoadRunner, Swoole, FrankenPHP) lo inicializan una vez por worker. Reinicia las behavior classes que guardan estado por petición, como cualquier otro servicio compartido.
© 2026 Alexander Lisachenko
