Configurar LiteMage Cache en Magento 2

LiteMage integra la caché de página completa de Magento 2 con LiteSpeed Enterprise. La mejora depende del catálogo, las páginas que puedan almacenarse y la tasa de aciertos; no se puede expresar como un porcentaje fijo.

La extensión de Magento es gratuita, pero solo funciona si el servidor dispone de una licencia LiteSpeed Enterprise con el módulo LiteMage habilitado. Confirma esta disponibilidad con soporte antes de instalarla.

Comprobaciones previas

• Utiliza una rama de Magento 2 que siga soportada y revisa sus requisitos de PHP, extensiones y Composer.
• Crea una copia recuperable y ensaya la instalación en staging.
• Comprueba que LiteMage esté habilitado en el servidor; instalar únicamente la extensión no activa la caché.

Para instalarlo necesitas experiencia con la terminal y acceso SSH, por lo que experiencia previa con la terminal es necesaria.

Instalación

Accede a la cuenta vía SSH y sitúate en el directorio de Magento. Anota el modo de despliegue actual y utiliza el PHP y Composer compatibles con esa instalación. Programa una ventana de mantenimiento antes de modificar una tienda en producción.

Si Magento está en modo production, pásalo temporalmente a developer siguiendo el procedimiento oficial de Magento. Instala después el paquete mantenido desde Composer:

composer require litespeed/module-litemage

Por medio de los siguientes comandos que deberán ser ejecutados uno a uno, procedemos a activar el módulo y recompilar los ficheros de configuración para que sea tenido en cuenta.

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

Si la tienda utilizaba el modo production, vuelve a activarlo al terminar. Este comando recompila las dependencias, despliega el contenido estático y limpia la caché durante el cambio de modo:

php bin/magento deploy:mode:set production

Comprueba que el comando termina sin errores y que el frontal carga sus recursos antes de reabrir la tienda.

Completamos editando el fichero .htaccess de Magento para añadir al inicio las siguientes líneas:

<IfModule LiteSpeed>
LiteMage on
</IfModule>

Puesta en marcha

Ya con LiteMage instalado, accedemos al administrador de Magento, sección Store > Configuration > Advanced > System y modificamos Full Page Cache de ser necesario para que aparezca LiteMage como el sistema de cache en uso.

Para terminar accedemos a System > Cache Management, y refrescamos la cache en Configuration y Page Cache, comprobando además que ambos aparezcan como activos.

Verificar y volver atrás

En una sesión sin iniciar, carga dos veces una página pública y revisa sus cabeceras en las herramientas del navegador. LiteMage puede mostrar X-LiteSpeed-Cache: hit, litemage cuando entrega una respuesta almacenada. Revisa también carrito, pago, monedas, idiomas y dos sesiones de cliente diferentes.

Si la instalación falla, no sigas ejecutando los comandos restantes. Conserva el error y restaura el despliegue anterior con su configuración. setup:upgrade puede modificar la base de datos: volver al código anterior no revierte por sí solo esos cambios. La recuperación debe respetar los pedidos y escrituras que se hayan producido.

Para dejar de usar LiteMage, cambia primero el sistema de caché de página completa siguiendo el procedimiento de Magento, limpia la caché y comprueba la tienda antes de retirar la extensión. Consulta la instalación oficial de LiteMage para los requisitos y comandos de tu versión.