Configurar LiteSpeed Cache en Drupal

LiteSpeed dispone de una caché integrada con la que Drupal puede evitar ejecuciones PHP repetidas para contenido compatible. La mejora depende del sitio, el contenido cacheable y la tasa de aciertos.

El módulo LiteSpeed Cache conecta las etiquetas y purgas de Drupal con esa caché. La web debe utilizar LiteSpeed u OpenLiteSpeed y el servidor debe tener la caché habilitada; instalar el módulo no sustituye este requisito.

La rama 1.3 documentada aquí requiere Drupal 10.3 o Drupal 11. Comprueba la versión estable y sus requisitos publicados antes de instalarla: no bajes la versión de Drupal ni fuerces Composer para eludir un conflicto.

1. Haz una copia de seguridad

Guarda una copia recuperable de los archivos y de la base de datos. Si la web tiene sesiones, formularios o contenido personalizado, realiza primero el cambio en un entorno de pruebas.

2. Instala el módulo con Composer

Desde el directorio raíz del proyecto ejecuta:

composer require 'drupal/lscache:^1.3'

Composer seleccionará una versión compatible dentro de esa rama. Para otras versiones de Drupal, utiliza el comando indicado en la página oficial del proyecto.

3. Activa LiteSpeed Cache

Activa LiteSpeed Cache desde Ampliar o mediante Drush:

vendor/bin/drush en lscache -y

Añade también las directivas requeridas al .htaccess de la raíz de Drupal:

<IfModule LiteSpeed>
    CacheLookup public on
    php_flag output_buffering off
</IfModule>

Sin ambas directivas, el módulo puede emitir sus cabeceras sin que LiteSpeed almacene las respuestas. El informe de estado de Drupal comprueba esta configuración. Las demás opciones del módulo están en Configuración > Desarrollo > LiteSpeed Cache.

4. Comprueba que funciona

Revisa el informe de estado de Drupal por si el módulo detecta directivas o datos del servidor pendientes.

Después, abre la web en una ventana privada, visita dos veces una página pública y revisa sus cabeceras de respuesta desde las herramientas de desarrollo del navegador. Una petición posterior de una página pública compatible puede mostrar una cabecera de LiteSpeed con estado hit; la primera puede aparecer como miss mientras se genera la caché. Comprueba que estás observando una petición al servidor, no una copia de memoria del navegador.

Si siempre aparece miss, revisa si la página depende de una sesión, una cookie o contenido personalizado. Confirma también que no haya otra caché de página interfiriendo.

No actives caché pública para páginas con datos privados o específicos de cada usuario sin comprobar antes el comportamiento de las sesiones.

Probar invalidación y desactivar

Edita un contenido de prueba y comprueba que el cambio aparece en sus páginas relacionadas. Prueba búsqueda, formularios, inicio y salida de sesión, y dos usuarios con permisos distintos. Las etiquetas de caché deben reflejar las dependencias reales de los módulos personalizados.

Si necesitas retirarlo, purga la caché y desinstala el módulo con el procedimiento de Drupal antes de retirar el paquete Composer. Conserva las demás reglas del .htaccess. Si el problema empezó al añadir las directivas, restaura ese cambio y revisa el informe de estado y el registro de errores.