Inspeccionar y vaciar la caché de POM

El grupo de herramientas más pequeño y el que más usarás, porque casi todos los demás flujos de trabajo de este capítulo terminan con «purga la caché».

Requisitos

• Caché de POM activa; de lo contrario, las herramientas no se registran.
• mcp:read para leer el estado; mcp:write para vaciar.

Observa lo que no se requiere: no hay una puerta dedicada de escritura en la caché. Vaciar la caché se rige únicamente por el ámbito mcp:write. Eso es proporcionado —purgar una caché destruye archivos derivados, no contenido—, pero implica que un token con ámbito de escritura puede vaciar la caché incluso cuando todas las puertas de contenido están cerradas.

Las dos herramientas

Comprueba primero el estado

Muéstrame el estado actual de la caché.

pom_cache_get_status informa de si la caché de POM está disponible y de qué contiene actualmente. Es de solo lectura y se puede llamar sin coste.

Útil más allá de la simple curiosidad: una caché vacía cuando esperabas que estuviera llena, o llena cuando esperabas que estuviera vacía, te dice algo sobre el sitio antes de que empieces a cambiar contenido.

Vaciado

Vacía la caché del sitio.

pom_cache_clear_site_cache elimina la caché HTML del sitio actual. También vacía la caché JSON progresiva de forma predeterminada; pasa include_json como false para conservarla.

La herramienta está marcada como destructiva y admite dry_run:

Usa una ejecución en seco y muéstrame qué se eliminaría.

En un sitio grande merece la pena hacerlo una vez, para que conozcas la magnitud de lo que una purga reconstruye.

Cuándo vaciar

Después de cualquier cambio que altere lo que ve un visitante:

• publicar o actualizar una entrada o página;
• cambios de taxonomía, que afectan a las páginas de archivo;
• cambios de menú, que aparecen en todas las páginas;
• cambios en los ajustes del tema, CSS o plantillas;
• cambios de producto, precio o cupón;
• cambios de opciones, como el título del sitio o las entradas por página.

El patrón es: haz el cambio, verifica el registro almacenado, luego purga y después mira la página renderizada. Verificar antes de purgar te dice que los datos son correctos; mirar después de purgar te dice que el sitio es correcto.

Vacía un solo sitio

La herramienta vacía la caché del sitio actual. En una red multisitio, cada sitio es un servidor MCP independiente con su propia caché, así que vaciar uno no hace nada por los demás.

Si un cambio afectó a varios sitios de una red, purga en cada uno.

Lo que no hace

• No invalida una CDN. La caché de origen y la caché de borde son copias diferentes. Después de purgar el origen, purga la CDN por separado o el borde seguirá sirviendo la página antigua.
• No desactiva el almacenamiento en caché. La caché se reconstruye en la siguiente petición.
• No vacía otras cachés: cachés de objetos, cachés de plugins, cachés del navegador.

El punto de la CDN es el que más suele pillar a la gente. Un cambio correcto, un origen purgado y un borde obsoleto parecen exactamente un cambio fallido.

Vaciar es barato; una purga completa no es gratis

Eliminar la caché significa que cada visitante posterior provoca una generación de página desde cero hasta que vuelve a llenarse. En un sitio con mucho tráfico, purgar todo durante el pico de tráfico produce un pico de carga.

Para un cambio que afecta a una sola página, plantéate si acaso está justificada una purga completa, o si la página se actualizará según su propio calendario.

Problemas comunes

Relacionado

• Herramientas de caché
• La documentación de la caché de POM para el modelo de almacenamiento en caché en sí