Gestión & supervisión del Cache Redis: configuración y ayuda

En tu Back Office, abre Módulos > "Module Manager", elige "Upload a module" y sube el ZIP del módulo. Instálalo y haz clic en Configurar. En versiones anteriores de PrestaShop, utiliza la página de módulos correspondiente.

Tu alojamiento ya debe proporcionar Redis y la extensión PHP Redis para el entorno de ejecución PHP web. El módulo gestiona una conexión, un panel y un explorador de claves. No instala Redis ni configura el backend de caché de tu tienda.

En el Back Office el módulo se llama Panel Redis y gestión de claves. Abre su pantalla Configuración. Empieza por Conexión. Introduce el servidor Redis, el puerto, la contraseña opcional, la base de datos y un prefijo de claves exclusivo. En Docker, utiliza el nombre del servicio Redis si 127.0.0.1 apunta al propio contenedor PHP.

Antes de guardar por primera vez, revisa Caché > Vaciar la caché al guardar la configuración, cuyo valor predeterminado es Sí. Desactívalo si solo quieres probar la conexión. Guarda y comprueba el resultado de la conexión.

Las pestañas son Conexión, Caché y Monitoreo. Conexión contiene el interruptor principal y los datos de Redis. Caché contiene las tres preferencias de caché almacenadas y el vaciado al guardar. Monitoreo controla las estadísticas del panel y la actualización automática.

• Activar módulo. Activa o desactiva la conexión del panel Redis y el explorador de claves; valor predeterminado: 1. Ajústalo en la pestaña Conexión.
• Servidor Redis. Define el nombre del servidor o la dirección IP de Redis; valor predeterminado: 127.0.0.1. En alojamientos Docker, utiliza el nombre del contenedor o del servicio Redis.
• Puerto Redis. Define el puerto TCP de Redis; valor predeterminado: 6379.
• Contraseña de Redis. Define la contraseña de autenticación de Redis; valor predeterminado: vacía. Un campo secreto en blanco conserva la contraseña almacenada. Usa el control de borrado del campo secreto para eliminarla cuando Redis ya no requiera autenticación.
• Índice de la base de datos Redis. Selecciona el número de la base de datos Redis; valor predeterminado: 0. Utiliza otro número solo si tu alojamiento te lo ha asignado.
• Prefijo de claves. Limita las búsquedas del explorador y los vaciados por prefijo a las claves que empiezan por este prefijo; valor predeterminado: ps_.
• Activar caché de objetos. Almacena la preferencia del módulo para usar Redis como backend de la caché de objetos de PrestaShop; valor predeterminado: 0. El módulo registra este ajuste, pero no reescribe por sí mismo los archivos de caché del servidor PrestaShop.
• Activar almacenamiento de sesiones. Almacena la preferencia del módulo para guardar las sesiones PHP en Redis; valor predeterminado: 0. Tu alojamiento o desarrollador aún debe configurar la gestión de sesiones del servidor/PHP.
• Activar caché de páginas completas. Almacena la preferencia del módulo para la caché de páginas completas de invitados; valor predeterminado: 0. Este módulo no añade por sí mismo una capa de caché de páginas a la tienda.
• Vaciar la caché al guardar la configuración. Elimina las claves que coinciden con el prefijo configurado después de guardar correctamente la configuración y probar la conexión; valor predeterminado: 1.
• Activar panel de supervisión. Controla la carga de las estadísticas del panel; valor predeterminado: 1. Requiere la extensión PHP Redis y que tanto este interruptor como Activar módulo estén activados.
• Intervalo de actualización del panel. Recarga automáticamente el panel con este intervalo en segundos; valor predeterminado: 30. Establece 0 para actualizar solo manualmente.

Los tres interruptores de caché no activan la caché de objetos, el almacenamiento de sesiones PHP ni la caché de páginas completas. La actualización automática funciona solo cuando la extensión PHP Redis está disponible y el módulo y la supervisión están activados. Se pausa mientras la pestaña está oculta o completas la confirmación para vaciar la base compartida. Usa la URL del panel sin parámetros de acción para no repetir una operación enviada.

Estos ejemplos describen valores de conexión; no son un formato de importación de archivos de entorno:

Local service: Redis Host=127.0.0.1, Redis Port=6379, Redis Database Index=0, Key Prefix=shop1_
Docker service: Redis Host=redis, Redis Port=6379, Redis Database Index=0, Key Prefix=shop1_

Utiliza la contraseña proporcionada por tu alojamiento. Si gestionas la configuración del despliegue en PHP, las claves almacenadas son REDIS_HOST, REDIS_PORT, REDIS_AUTH, REDIS_DB, REDIS_PREFIX, FLUSH_ON_SAVE, MONITOR_ENABLED y STATS_REFRESH bajo ConfigTable::setMultiple('mprinstantredis', [...]).

Abre el panel del módulo y utiliza su prueba de conexión. Informa de la versión de Redis, los detalles de conexión, el tiempo de actividad, la memoria, la tasa de aciertos, las operaciones por segundo, los clientes, las expulsiones y la información de caducidad. Son estadísticas del servidor Redis, no mediciones limitadas a tu prefijo. El número total de claves se suma a partir de las entradas de bases de datos de Redis INFO.

Abre Explorador de claves. "Pattern" tiene el valor predeterminado *. "Limit" tiene el valor predeterminado 100 y admite de 1 a 1000. El prefijo configurado se antepone a tu búsqueda:

Key Prefix: ps_
Pattern: *           scans ps_*
Pattern: product:*   scans ps_product:*

La lista muestra la clave sin el prefijo, su tipo, TTL y tamaño/cantidad. Inspecciona cadenas, listas, conjuntos, conjuntos ordenados y hashes. Las vistas previas de listas y conjuntos ordenados se limitan a las primeras 100 entradas. Utiliza la acción Eliminar de la fila solo para las claves que quieras eliminar. Se admiten solicitudes de eliminación masiva, pero el explorador de claves no tiene controles de selección múltiple.

Utiliza Vaciar el espacio de nombres del panel Redis y de la gestión de claves para el espacio de nombres propio del módulo. Un vaciado busca y elimina las claves con el prefijo literal configurado. La propiedad vacía y el solapamiento con otro propietario registrado bloquean la eliminación. Las mismas comprobaciones de propiedad se aplican a la eliminación de filas y al vaciado al guardar.

Para un restablecimiento completo, el panel ofrece Vaciar base compartida como una operación independiente solo cuando la coordinación de espacios de nombres está lista. Revisa los propietarios, marca la casilla de aceptación y escribe la frase de confirmación que aparece en pantalla. Un manifiesto de propiedad obsoleto o una coordinación no disponible bloquean la operación. Un vaciado completo elimina todas las claves de la base Redis seleccionada, incluidas las de aplicaciones ajenas. Revisa el contenido de esas claves antes de utilizarlo.

1. Guarda los datos de conexión y confirma el mensaje Conexión con Redis verificada.
2. Abre el panel y comprueba el servidor y el puerto con respecto a la instancia Redis prevista.
3. Busca una clave conocida en Explorador de claves. Un número de claves del servidor superior a cero sin claves coincidentes en el explorador puede significar que el prefijo es incorrecto.
4. Si aparece la advertencia de la extensión, activa php-redis para el entorno de ejecución PHP que sirve el Back Office. Activarla solo para la línea de comandos (CLI) no basta.
5. Si falla la conexión, comprueba con tu alojamiento la accesibilidad de la red, el nombre del servidor, las credenciales y los permisos de la base de datos.
6. Si la eliminación está bloqueada, comprueba el prefijo exclusivo y el solapamiento de propietarios registrados. No amplíes el prefijo para eludir la protección.

Lee la tasa de aciertos junto con la memoria y las expulsiones. Es la proporción entre los aciertos de Redis y la suma de aciertos y fallos en todo el servidor. Eliminar claves puede forzar la reconstrucción de la caché. Si Redis también almacena sesiones u otros datos de aplicaciones, la eliminación puede afectar a esas aplicaciones.

Utiliza Integridad para las comprobaciones del módulo. Los identificadores de los controladores son AdminMPRInstantRedis para el panel, AdminMPRInstantRedisConfig para la configuración, AdminMPRInstantRedisBrowser para la exploración y AdminMPRInstantRedisIntegrity para la integridad.

Establece Activar módulo en No para detener las conexiones normales del panel/explorador. Desinstala mediante "Module Manager" para eliminar la configuración y los menús del módulo. La rutina de desinstalación no vacía Redis ni elimina el servidor Redis. Revisa por separado la configuración independiente de caché y sesiones de tu alojamiento.

Requiere PrestaShop 1.6.1 o posterior y PHP 7.1 o posterior.