Integrar LiteSpeed Cache en Laravel

Laravel puede utilizar LiteSpeed para almacenar respuestas HTTP de rutas compatibles. Es útil cuando una página puede reutilizarse sin ejecutar toda la aplicación. No sustituye la optimización de consultas ni el almacén de caché de Laravel, que puede utilizar Redis u otro controlador.

Preparar la integración

Comprueba la compatibilidad de tu versión de PHP y Laravel con litespeed/lscache-laravel. Prueba en staging y conserva el código, el archivo de dependencias bloqueadas y la configuración anteriores.

Desde la raíz del proyecto:

composer require litespeed/lscache-laravel
php artisan vendor:publish --provider='Litespeed\LSCache\LSCacheServiceProvider'

Ejecuta cada comando solo si el anterior termina correctamente. Revisa el archivo de configuración publicado sin sobrescribir una configuración existente a ciegas. El paquete utiliza el descubrimiento automático de Laravel; no copies instrucciones de registro de proveedores o de Kernel.php de una rama antigua a un proyecto actual.

Para que LiteSpeed busque respuestas almacenadas, la documentación del paquete indica esta regla en el .htaccess público de la aplicación, conservando las reglas de Laravel:

<IfModule LiteSpeed>
    CacheLookup on
</IfModule>

Elegir rutas y una política de purga

Empieza por una ruta de lectura que devuelva exactamente el mismo contenido a todos los visitantes. El middleware del paquete permite definir una duración y si la respuesta es pública, privada o no almacenable. Mantén los valores globales sin caché mientras diseñas qué rutas pueden utilizarla.

No conviertas todo el grupo web o el administrador en caché pública. Una página que parezca informativa puede incluir nombre de usuario, token CSRF, moneda, idioma o datos de sesión en su plantilla. Esos elementos requieren exclusiones o un diseño específico.

Define también cuándo invalidar las respuestas: publicar una noticia o cambiar un precio debe retirar las páginas relacionadas. El paquete proporciona etiquetas y funciones de purga; utiliza las correspondientes a tu versión y al modelo de contenido del proyecto.

Comprobar antes del despliegue

Prueba una ruta pública varias veces y revisa sus cabeceras HTTP: emitir una cabecera de control no demuestra que el servidor haya almacenado la respuesta. Busca un acierto de caché en una petición posterior.

Comprueba dos sesiones independientes, idiomas y cualquier variante relevante. Actualiza el contenido de prueba y verifica que la purga lo hace visible. Login, logout, formularios y operaciones con efectos deben conservar su comportamiento.

Si aparece contenido de otra sesión, desactiva la política de caché afectada y purga sus respuestas de inmediato. Para retirar la integración, revierte middleware y configuración, purga la caché y después retira la dependencia con tu procedimiento de despliegue. No basta con quitar el paquete mientras quedan respuestas almacenadas.