LiteMage Cache en Magento 2: instalar y configurar

LiteMage es el módulo de LiteSpeed que sustituye la caché de página completa de Magento 2 por la caché integrada en el servidor web LiteSpeed. Las páginas de categoría y producto se sirven directamente desde el servidor, y los bloques personales (carrito, cliente) se cargan aparte con ESI.

El módulo es gratuito y nuestros servidores tienen LiteMage incluido en la licencia de LiteSpeed, así que puedes instalarlo directamente.

Antes de empezar

• Haz una copia de archivos y base de datos: setup:upgrade modifica la base de datos.
• En Seleccionar versión de PHP, comprueba que usas una versión de PHP compatible con tu Magento y que memory_limit es de al menos 756M (lo que pide Magento 2.4; para los comandos de compilación, mejor 2G) y max_execution_time de al menos 300.
• Necesitas acceso por SSH o el Terminal de cPanel.

1. Instalar el módulo

Conéctate por SSH, entra en la carpeta de Magento y pon la tienda en modo mantenimiento:

php bin/magento maintenance:enable

Si la tienda está en modo production, pásala a developer mientras instalas:

php bin/magento deploy:mode:set developer

Instala el módulo con Composer:

composer require litespeed/module-litemage

Actívalo y recompila, ejecutando los comandos de uno en uno y comprobando que cada uno termina sin errores:

php bin/magento module:enable Litespeed_Litemage
php bin/magento setup:upgrade
php bin/magento setup:di:compile

Vuelve a modo production (recompila y despliega los ficheros estáticos) y quita el mantenimiento:

php bin/magento deploy:mode:set production
php bin/magento maintenance:disable

Si un comando falla, no sigas con el siguiente: copia el error y restaura la copia si la tienda no carga.

2. Activar LiteMage en el .htaccess

Edita el .htaccess de la carpeta de Magento y añade al principio:

<IfModule LiteSpeed>
LiteMage on
</IfModule>

3. Seleccionar LiteMage como caché

En el administrador de Magento, ve a Stores > Configuration > Advanced > System, despliega Full Page Cache y en Caching Application elige LiteMage Cache Built-in to LiteSpeed Server (desmarca antes Use system value). Guarda.

Después ve a System > Cache Management, marca Configuration y Page Cache, elige Refresh y pulsa Submit. Comprueba que ambas aparecen como ENABLED.

Comprobar que funciona

Abre una categoría en una ventana privada, pulsa F12, ve a Red (Network) y recarga dos veces. En el documento HTML, la cabecera X-LiteSpeed-Cache debe mostrar hit,litemage a partir de la segunda visita.

Prueba también a añadir un producto al carrito, iniciar sesión como cliente y cambiar de idioma o moneda si los usas.

Para dejar de usar LiteMage, vuelve a poner Built-in Cache en Caching Application, refresca la caché, quita el bloque del .htaccess y después desactiva el módulo con php bin/magento module:disable Litespeed_Litemage.

Tienes más opciones en la documentación oficial de LiteMage.