LiteSpeed Cache para Drupal: instalar y configurar

Nuestros servidores usan LiteSpeed, que lleva una caché de páginas integrada. El módulo LiteSpeed Cache para Drupal, de la propia LiteSpeed, conecta Drupal con esa caché: las páginas se generan una vez y las siguientes visitas las sirve el servidor directamente, sin ejecutar PHP. Además usa las etiquetas de caché de Drupal para vaciar solo lo que cambia al editar un contenido.

La versión actual del módulo es la 1.3.x, para Drupal 10.3 y Drupal 11. Haz una copia de archivos y base de datos antes de empezar.

1. Instalar el módulo

Conéctate por SSH o abre el Terminal de cPanel, entra en la carpeta raíz del proyecto (donde está composer.json) y ejecuta:

composer require 'drupal/lscache:^1.3'
vendor/bin/drush en lscache -y

Si prefieres no usar Drush, tras el composer require activa el módulo en Ampliar (Extend): búscalo como «LiteSpeed Cache», márcalo y pulsa Instalar.

2. Añadir las directivas al .htaccess

Edita el .htaccess de la carpeta pública de Drupal (la que contiene index.php) y añade al principio:

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

Sin estas líneas, el módulo envía sus cabeceras pero el servidor no guarda las páginas. Informes > Informe de estado de Drupal te avisa si faltan.

3. Ajustes

Las opciones están en Configuración > Desarrollo > LiteSpeed Cache: activar o desactivar la caché, el tiempo que se guardan las páginas públicas y privadas, y un botón para vaciarla entera.

Los valores por defecto sirven para la mayoría de webs. No hace falta vaciar la caché al editar contenido: el módulo purga solo las páginas relacionadas.

4. Comprobar que funciona

1. Abre la web en una ventana privada (sin iniciar sesión).
2. Pulsa F12, ve a la pestaña Red (Network) y recarga dos veces.
3. En la primera petición (el documento HTML), la cabecera X-LiteSpeed-Cache debe mostrar miss la primera vez y hit después.

Si siempre sale miss, revisa el informe de estado y que las directivas del .htaccess estén al principio del fichero. Las páginas que dependen de la sesión (carrito, área privada) no se guardan en la caché pública, y es lo correcto.

Desinstalarlo

Desinstala el módulo en Ampliar > Desinstalar (o vendor/bin/drush pmu lscache -y), retira el paquete con composer remove drupal/lscache y quita el bloque del .htaccess.