Behavior de caché
Cachea los resultados de los métodos lentos con un solo atributo. Un behavior #[Cacheable] con almacenamiento PSR-16 que funciona en clases final, clases readonly y métodos estáticos.
Traducido del inglés. La página en inglés es la referencia. Leer el original
Tu responsable te reenvía una queja: la página de pago tarda tres segundos. El profiler señala un método que, en cada llamada, pide a un servicio remoto un tipo de cambio, aunque ese tipo cambia unas pocas veces al día. La respuesta es obvia: cachearlo. Lo interesante es dónde va el código de caché.
Esta página va del arreglo rápido a un behavior (comportamiento) de caché: marcas un método con #[Cacheable] y el framework ejecuta la consulta a la caché como middleware a su alrededor. Los términos behavior class (clase de comportamiento), behavior y matching rule (regla de coincidencia) se explican en la tabla de términos.
El problema
Sección titulada «El problema»El servicio lento:
final readonly class ExchangeRates{ public function __construct(private RateSource $source) {}
public function rate(string $from, string $to): float { return $this->source->fetch($from, $to); // a remote call, ~1 s }}El arreglo rápido mete la caché dentro del método:
use Psr\SimpleCache\CacheInterface;
final readonly class ExchangeRates{ public function __construct( private RateSource $source, private CacheInterface $cache, ) {}
public function rate(string $from, string $to): float { $key = "rate.$from.$to"; $rate = $this->cache->get($key); if ($rate === null) { $rate = $this->source->fetch($from, $to); $this->cache->set($key, $rate, 600); }
return $rate; }}Funciona, y empieza a extenderse:
- La clase tiene dos trabajos. Obtiene tipos de cambio y gestiona una caché. Cada test de
ExchangeRatesnecesita ahora una caché, y la dependencia de la caché viaja a cada llamada al constructor. - Las mismas líneas se copian en cada método lento. Cada copia construye su propia clave, elige su propio tiempo de vida y gestiona los fallos de caché a su manera. Tarde o temprano una copia olvida un argumento en la clave y devuelve datos incorrectos.
- No hay un único lugar donde cambiarlo. Desactivar la caché para una ejecución de tests, renombrar claves o cambiar el almacenamiento implica editar cada copia.
Por qué los decoradores y los proxies se quedan cortos
Sección titulada «Por qué los decoradores y los proxies se quedan cortos»El diseño orientado a objetos tiene dos respuestas clásicas, y el código PHP moderno bloquea las dos:
- Una subclase con caché sobrescribe los métodos lentos y llama a
parent::rate()cuando no hay acierto. No puede extender una clasefinal, y muchos servicios modernos sonfinal readonly. - Un decorador envuelve el servicio e implementa la misma interfaz. Necesita una interfaz para cada servicio y un método de reenvío para cada método, se cachee o no. Un proxy genérico con
__call()ahorra tecleo, pero ya no es unExchangeRates, así que cualquier type hint lo rechaza. - Ninguno de los dos puede cachear un método estático. Quien llama nombra la clase directamente, así que no hay nada que envolver.
El behavior de caché
Sección titulada «El behavior de caché»La lógica de caché va a una sola behavior class, y los métodos que la necesitan se marcan con un atributo. Cuatro archivos pequeños.
1. El atributo
Sección titulada «1. El atributo»namespace App\Attribute;
use Attribute;
#[Attribute(Attribute::TARGET_METHOD)]final readonly class Cacheable{ public function __construct(public int $ttl = 300) {}}Un atributo PHP corriente. Lleva el ajuste que cambia de un método a otro, el tiempo de vida en segundos, y no depende del framework.
2. Marca el método
Sección titulada «2. Marca el método»use App\Attribute\Cacheable;
final readonly class ExchangeRates{ public function __construct(private RateSource $source) {}
#[Cacheable(ttl: 600)] public function rate(string $from, string $to): float { return $this->source->fetch($from, $to); }}El método vuelve a tener una sola línea, y la clase vuelve a tener una sola dependencia.
3. La behavior class
Sección titulada «3. La behavior class»namespace App\Aspect;
use App\Attribute\Cacheable;use Go\Aop\Aspect;use Go\Aop\Intercept\MethodInvocation;use Go\Lang\Attribute\Around;use Psr\SimpleCache\CacheInterface;
final class CachingAspect implements Aspect{ public function __construct(private readonly CacheInterface $cache) {}
#[Around('@execution(App\Attribute\Cacheable)')] public function cache(MethodInvocation $invocation): mixed { $method = $invocation->getMethod(); $key = 'call.' . hash('xxh128', $invocation->getScope() . '::' . $method->name . serialize($invocation->getArguments()));
$miss = new \stdClass(); $value = $this->cache->get($key, $miss); if ($value !== $miss) { return $value; }
$ttl = $method->getAttributes(Cacheable::class)[0]->newInstance()->ttl; $value = $invocation->proceed(); $this->cache->set($key, $value, $ttl);
return $value; }}#[Around] ejecuta el behavior en lugar del método. La matching rule @execution(App\Attribute\Cacheable) selecciona todos los métodos que llevan el atributo. Por dentro:
- La clave nombra la clase, el método y los argumentos, así que
rate('EUR', 'USD')yrate('USD', 'EUR')obtienen entradas distintas. Se calcula un hash porque PSR-16 reserva los caracteres{}()/\@:y solo garantiza claves de hasta 64 caracteres. $misses un objeto recién creado que ninguna caché puede devolver, así que también se cachean los métodos que devuelvennullofalse.proceed()ejecuta el método original, solo cuando no hay acierto. El tiempo de vida sale del atributo de ese método.getScope()devuelve el nombre de la clase tanto en llamadas de instancia como en llamadas estáticas.getThis()seríanullen una llamada estática.
4. Registra la behavior class
Sección titulada «4. Registra la behavior class»use App\Aspect\CachingAspect;use Go\Core\AspectContainer;use Go\Core\AspectKernel;use Psr\SimpleCache\CacheInterface;
final class AppKernel extends AspectKernel{ protected function configureAop(AspectContainer $container): void { $container->addLazyService( CachingAspect::class, static fn(AspectContainer $c) => new CachingAspect($c->getService(CacheInterface::class)), ); }}La caché sale del contenedor de tu aplicación una vez conectado con setDelegate() (consulta Dependencias). Con el bridge de Symfony, Laravel o Yii3 te saltas este paso: la behavior class es un servicio con autowiring como cualquier otro (Integraciones). Sirve cualquier implementación de PSR-16, por ejemplo symfony/cache con Psr16Cache.
Lo que obtienes
Sección titulada «Lo que obtienes»$rates->rate('EUR', 'USD'); // calls the remote service, stores the result for 600 s$rates->rate('EUR', 'USD'); // returns the stored rate$rates->rate('USD', 'EUR'); // other arguments: calls the remote service-
Las clases final y readonly funcionan. La clase conserva su nombre y su declaración
final readonly. Los type hints,instanceofynew ExchangeRates(...)no cambian, porque no existe ningún objeto envoltorio. -
Los métodos estáticos también funcionan, algo que ningún decorador puede hacer:
final class Countries{#[Cacheable(ttl: 86400)]public static function all(): array{// reads a large file}} -
Un solo lugar que cambiar. El esquema de claves, el almacenamiento y las reglas viven en
CachingAspect. Marcar o desmarcar un método es un cambio de una línea en un diff fácil de revisar. -
Puedes comprobarlo.
vendor/bin/aspect debug:advisor public/index.php --advisor=...lista todos los métodos que selecciona la regla (consulta debug:advisor), y un breakpoint dentro decache()se detiene en cada llamada cacheada. -
El coste es pequeño. Interceptar una llamada cuesta menos de 1 µs (costes medidos), frente a los segundos de una llamada remota.
Detalles que decidir
Sección titulada «Detalles que decidir»- Los argumentos deben ser serializables.
serialize()lanza una excepción con los closures y con algunos objetos. En el caso de las entidades, pasa sus identificadores a los métodos cacheados o construye la clave con las partes que necesites. - El estado del objeto no forma parte de la clave. Dos instancias de
ExchangeRatescon fuentes distintas comparten entradas. Si el resultado depende de la instancia, añade a la clave un valor que la identifique. - Invalidación. La frase de Phil Karlton sigue vigente: en informática solo hay dos cosas difíciles, invalidar la caché y poner nombres a las cosas. Un tiempo de vida es la política más sencilla. Cuando los datos deben desaparecer en el momento en que cambian, usa una caché que admita etiquetas (por ejemplo,
TagAwareCacheInterfacede Symfony) y un segundo behavior en los métodos que escriben esos datos. - Acota la regla si lo necesitas. Combina el atributo con otras reglas, por ejemplo
@execution(App\Attribute\Cacheable) && within(App\Service\**). La sintaxis está en Matching rules.
© 2026 Alexander Lisachenko
