Actualizaciones, soporte y mantenimiento seguro

Las actualizaciones de POM Cache llegan a través del canal privado de actualizaciones de POM. Como el plugin participa en el arranque temprano de WordPress y Apache puede servir archivos sin PHP, el mantenimiento debe tener en cuenta algo más que el directorio del plugin.

Antes de una actualización

  1. Lee las notas de la versión para conocer los cambios en el formato de caché, el drop-in, los ajustes, las reglas de reescritura, la invalidación o el JSON progresivo.
  2. Confirma que la licencia de sitio o de red de POM Cache es válida.
  3. Confirma que la suscripción está activa y que el dominio actual sigue autorizado.
  4. Haz una copia de seguridad de:
    • wp-config.php;
    • el .htaccess principal;
    • wp-content/advanced-cache.php;
    • cualquier configuración de caché gestionada por el despliegue.
  5. Anota los recuentos actuales de HTML y JSON en General.
  6. Prueba una petición dinámica y un acierto de caché confirmado.
  7. Programa la actualización para un momento en el que sea aceptable una purga del sitio actual y, si es necesario, de la CDN.

El actualizador común de POM puede anunciar una nueva versión incluso cuando el plugin de destino está inactivo. En multisitio, esto incluye la detección desde la pantalla de actualización de la red. POM Cache debe estar instalado y tener una licencia de sitio o de red válida para acceder a los metadatos y las descargas restringidos.

Aplicar y verificar la actualización

Utiliza el flujo normal de actualización de plugins de WordPress o el flujo de actualización de plugins de la red en multisitio.

Después de actualizar los archivos:

  1. Confirma que WordPress informa de la versión esperada de POM Cache.
  2. Abre POM Cache → Advanced → WordPress configuration.
  3. Confirma que el advanced-cache.php instalado sigue coincidiendo con el origen esperado.
  4. Compara las reglas de Apache y de JSON progresivo mostradas cuando las notas de la versión mencionen cambios en la entrega.
  5. Confirma que los ajustes existentes conservan los valores previstos.
  6. Purga el HTML y el JSON del sitio actual si cambió la salida renderizada, el formato de archivo o el comportamiento de entrega.
  7. Invalida los objetos de CDN correspondientes cuando sea necesario.
  8. Repite la verificación de primera caché.
  9. Prueba una petición autenticada y una ruta personalizada.

POM Cache nunca actualiza automáticamente wp-config.php, .htaccess ni el drop-in desplegado. Una actualización correcta del plugin no demuestra que esos archivos externos estén al día.

Mantenimiento rutinario

Después de cambios editoriales

Si el interruptor de purga automática correspondiente está activado, verifica que la caché esperada del sitio actual se haya eliminado y regenerado. Si está desactivado, usa Delete Cache, Delete Progressive JSON Cache o la acción de la barra de administración según la capa afectada.

Después de cambios de tema, plugin o plantilla

Limpia todas las capas de caché que contengan la salida renderizada antigua. Un cambio de activos solo de CSS puede resolverse con la política de versionado de activos/CDN, mientras que un cambio de plantilla o de marcado renderizado en el servidor normalmente requiere la regeneración del HTML.

Después de cambiar dominios o el mapeo de multisitio

Revalida la licencia para el dominio correcto, revisa las suposiciones de reescritura de host/ruta, elimina los archivos de caché obsoletos específicos de un host mediante las herramientas de ámbito admitidas y prueba la nueva ruta pública desde el origen hacia afuera.

Supervisar el almacenamiento

Revisa Cache Contents y Progressive JSON Cache Contents con regularidad. El plugin no elimina archivos simplemente porque sean antiguos. Un aumento inesperado puede indicar más rutas públicas, un patrón de URL sin control, una laguna en la invalidación o respuestas JSON que necesitan un límite de tamaño inferior.

Secuencia segura de resolución de problemas

Cuando los visitantes informan de contenido obsoleto o incorrecto:

  1. Identifica si la respuesta es HTML, JSON progresivo, una imagen u otro activo.
  2. Prueba el origen de WordPress sin depender de la CDN.
  3. Compara una petición sin sesión iniciada con una petición autenticada.
  4. Comprueba el host, la ruta, la cadena de consulta, las cookies, las cabeceras de respuesta y la marca de tiempo de caché exactos.
  5. Limpia solo la capa del sitio actual afectada.
  6. Regenera y verifica el origen.
  7. Invalida el objeto de la CDN si el edge aún conserva la respuesta antigua.

Evita eliminar repetidamente toda la caché de la red. Una purga amplia puede ocultar el alcance original y crea trabajo de regeneración innecesario.

Información que debes incluir en una solicitud de soporte

Proporciona:

  • versiones de POM Cache, WordPress y PHP;
  • topología de sitio único o multisitio y el dominio del sitio afectado;
  • presencia de Apache, otro servidor web y CDN;
  • la URL pública exacta sin tokens privados;
  • si el problema ocurre sin sesión iniciada, con sesión iniciada o en ambos casos;
  • los ajustes de POM Cache relevantes por su etiqueta visible;
  • el estado de Advanced → WordPress configuration;
  • los recuentos de caché de HTML y JSON;
  • cabeceras de respuesta saneadas;
  • la marca de tiempo del comentario de caché cuando esté presente;
  • los pasos que reproducen el resultado;
  • qué cambió inmediatamente antes del problema.

No envíes nunca:

  • la clave de licencia;
  • credenciales de WordPress, alojamiento, CDN o base de datos;
  • cookies de autenticación sin procesar;
  • datos privados de clientes;
  • un registro de servidor sin censurar.

Consideraciones de recuperación

Desactivar POM Cache desactiva su ajuste en tiempo de ejecución, pero no elimina los archivos estáticos existentes, las reglas de reescritura, las constantes ni el drop-in. Apache puede seguir sirviendo un archivo coincidente mientras su regla permanezca activa.

Para una reversión de diagnóstico controlada:

  1. omite o invalida la CDN;
  2. elimina o desactiva el bloque de reescritura de POM Cache;
  3. elimina la caché de HTML y JSON afectada mediante las herramientas admitidas;
  4. desactiva los interruptores en tiempo de ejecución;
  5. restaura el drop-in o las constantes anteriores solo cuando la migración documentada lo requiera.

No elimines directorios amplios manualmente a menos que se hayan verificado el destino exacto del sitio actual y el plan de recuperación.

Vuelve al capítulo de inicio de POM Cache para consultar la ruta de documentación sobre almacenamiento en caché de HTML, Apache, JSON, invalidación, supervisión y hooks para desarrolladores.

Lista de verificación de caché en producción
Anterior
Conceptos de caché
Siguiente