Introduction | laravel-responsecache

https://spatie.be/docs/laravel-responsecache/v8/introduction • Feb 20, 2026 02:48

Extracto

laravel-responsecache

Resumen

Resumen Principal

El paquete Laravel Response Cache es una solución robusta y altamente eficaz diseñada para mejorar drásticamente la velocidad y el rendimiento de las aplicaciones Laravel. Su principio fundamental radica en la captura y almacenamiento de respuestas HTTP completas la primera vez que se realiza una solicitud. Cuando la misma solicitud se recibe nuevamente, en lugar de ejecutar la aplicación completa, el paquete devuelve la respuesta previamente almacenada en caché, lo que resulta en una entrega casi instantánea. Por defecto, este sistema optimiza todas las solicitudes GET exitosas que retornan contenido basado en texto, como HTML y JSON, manteniendo las respuestas en caché durante una semana. Una característica clave es su capacidad para gestionar cachés separadas para usuarios autenticados, asegurando que cada usuario reciba una experiencia personalizada sin comprometer el rendimiento general. Además de la caché estándar, introduce una caché flexible que permite servir respuestas ligeramente desactualizadas mientras la caché se refresca discretamente en segundo plano, garantizando una disponibilidad constante y una experiencia de usuario fluida incluso durante la actualización de datos.

Elementos Clave

Mecanismo de Aceleración por Omisión de Proceso: El paquete Laravel Response Cache opera interrumpiendo el flujo de ejecución completo de la aplicación en solicitudes repetidas. Almacena la respuesta generada por la aplicación la primera vez que se accede a una URL y, en visitas subsiguientes a esa misma URL, sirve la respuesta guardada directamente desde la caché. Este proceso elimina la necesidad de re-ejecutar controladores, consultas a bases de datos y la renderización de vistas, lo que se traduce en una mejora considerable y medible en los tiempos de respuesta.
Caché Personalizada para Usuarios Autenticados: Una funcionalidad crucial para aplicaciones dinámicas es la gestión de contenido específico por usuario. El paquete aborda esto eficazmente al proporcionar una caché separada para cada usuario autenticado. Esto significa que las respuestas personalizadas, como un panel de control o contenido específico de perfil, se almacenarán y servirán individualmente para cada usuario que haya iniciado sesión, garantizando que la experiencia de usuario sea tanto rápida como relevante y segura, sin mezclar los datos de diferentes usuarios.
Configuración Predeterminada y Amplia Compatibilidad: De manera predeterminada, el paquete está configurado para optimizar la mayoría de los escenarios comunes. Cacha automáticamente todas las solicitudes GET exitosas que devuelven contenido basado en texto, incluyendo formatos tan prevalentes como HTML y JSON. Esta configuración estándar, que mantiene las respuestas en caché durante una semana, ofrece un punto de partida robusto para la mayoría de las aplicaciones, proporcionando beneficios de rendimiento out-of-the-box sin requerir una configuración exhaustiva.
Estrategia de Caché Flexible para Máxima Disponibilidad (FlexibleCacheResponse): Para escenarios donde la frescura inmediata de los datos puede ser ligeramente sacrificada en favor de una disponibilidad y velocidad constantes, el paquete ofrece la opción de caché flexible. Esta modalidad sirve una respuesta almacenada en caché que puede estar levemente "rancia" (es decir, cuya vida útil ya ha expirado) de manera instantánea, mientras que, de forma asíncrona y en segundo plano, inicia el proceso de refrescar esa caché. Esto asegura que los usuarios siempre reciban una respuesta ultrarrápida, eliminando los tiempos de espera incluso durante la regeneración del contenido, y solo se recalculará completamente si el "periodo de gracia" también ha expirado.

Análisis e Implicaciones

Este paquete tiene implicaciones significativas para la escalabilidad y la experiencia del usuario en aplicaciones Laravel. Al reducir drásticamente los tiempos de respuesta, mejora la percepción de velocidad y fluidez, lo que puede aumentar la satisfacción del usuario y la retención. Para los desarrolladores, simplifica un aspecto crítico de la optimización del rendimiento, permitiendo enfocar los recursos en la lógica de negocio en lugar de complejas estrategias de caching.

Contexto Adicional

La facilidad de gestión de la caché, ya sea a través de un simple comando Artisan o programáticamente, lo convierte en una herramienta versátil. Constituye una solución poderosa y fácil de integrar para abordar cuellos de botella comunes en el rendimiento de cualquier aplicación web moderna.

Contenido

Laravel Response Cache

The first time a request comes in, the package will save the response before sending it to the user. When the same request comes in again, the cached response is returned without going through the entire application. This will greatly speed up your app.

This Laravel package can cache an entire response. By default it will cache all successful GET requests that return text based content (such as HTML and JSON) for a week. This could potentially speed up the response quite considerably.

The first time a request comes in, the package will save the response before sending it to the user. When the same request comes in again, the cached response is returned without going through the entire application. Logged in users will each have their own separate cache.

Here's a quick example:

use Spatie\ResponseCache\Middlewares\CacheResponse;

Route::middleware(CacheResponse::for(minutes(10)))->group(function () {
    Route::get('/posts', [PostController::class, 'index']);
    Route::get('/posts/{post}', [PostController::class, 'show']);
});

For pages where brief staleness is acceptable, you can use flexible caching. After the lifetime expires, the stale response is still served instantly while the cache refreshes in the background. Once the grace period is over, the cache is considered expired and the next request will be fully recalculated.

Here's an example:

use Spatie\ResponseCache\Middlewares\FlexibleCacheResponse;

Route::get('/dashboard', [DashboardController::class, 'index'])
    ->middleware(FlexibleCacheResponse::for(lifetime: hours(1), grace: minutes(5)));

The cache can be cleared programmatically or via an artisan command.

use Spatie\ResponseCache\Facades\ResponseCache;

ResponseCache::clear();

php artisan responsecache:clear

Absortio