Requisitos y compatibilidad

Revisa esta página antes de instalar POM Cache. POM Cache es compatible tanto con WordPress de sitio único como con multisitio. Su configuración estándar de entrega directa utiliza Apache y guarda archivos estáticos en un sistema de archivos al que tanto PHP como el servidor web pueden acceder.

Requisitos de plataforma

CloudFront se recomienda en la arquitectura POM estándar, pero es una capa de borde independiente. POM Cache puede crear archivos de origen sin CloudFront; la CDN normalmente se encarga del almacenamiento en caché de borde y de la compresión Brotli.

Constantes de WordPress requeridas

Añade ambas constantes a wp-config.php antes de que WordPress cargue sus ajustes:

define( 'WP_CACHE', true );
define( 'POM_CACHE_HOME', WP_CONTENT_DIR . '/plugins/pom-cache/' );

POM_CACHE_HOME debe resolver al directorio real del plugin e incluir la barra diagonal final. La sección Advanced → WordPress configuration muestra los valores esperados y detectados sin modificar el archivo.

Propiedad del drop-in

WordPress proporciona un único espacio wp-content/advanced-cache.php para toda la instalación. Antes de instalar POM Cache, determina si otro plugin de caché de páginas es propietario de ese archivo.

No sobrescribas un drop-in desconocido. Desactiva y migra desde la solución de caché anterior siguiendo sus instrucciones, conserva una copia de seguridad y luego instala el archivo fuente de POM Cache:

wp-content/plugins/pom-cache/pom-cache-advanced-cache.php

como:

wp-content/advanced-cache.php

La pestaña Advanced de POM Cache identifica si el archivo desplegado coincide con el drop-in esperado de POM Cache.

Sistema de archivos y alojamiento multinodo

PHP necesita permisos para crear directorios y archivos bajo la base de caché configurada. Apache necesita permisos para leerlos.

Si varios servidores de origen gestionan el mismo nombre de host, deben compartir el almacenamiento de caché o utilizar una arquitectura que mantenga la generación, la invalidación y la entrega coherentes entre nodos. POM Cache no replica archivos entre servidores.

No apuntes la ubicación de la caché a /, a una ruta efímera que desaparece de forma inesperada, ni a un directorio que el servidor web público no pueda asignar a las reglas proporcionadas.

Comportamiento en sitio único y multisitio

En una instalación de sitio único, la activación, los ajustes, la gestión de la licencia y las herramientas de caché del sitio actual pertenecen a ese sitio.

En multisitio, la activación en red es el despliegue normal. Las rutas de caché distinguen el host actual y, cuando corresponde, la ruta del subsitio. Las acciones de eliminación manual siguen operando solo sobre el sitio actual.

Los ajustes guardados para el sitio actual tienen prioridad. Los valores faltantes específicos del sitio pueden recurrir a las alternativas del sitio principal en cuanto a los ajustes efectivos. Utiliza Fix Configuration solo cuando quieras escribir intencionadamente esos valores efectivos para el sitio actual.

La licencia de red/sitio principal controla las actualizaciones privadas en multisitio. Un subsitio no es una instalación independiente de licencia de POM Cache.

Compatibilidad de contenido

POM Cache funciona mejor cuando una solicitud anónima GET tiene una única representación pública. Revisa cualquier característica que varíe el HTML sin una cookie privada o URL reconocida:

• geolocalización o renderizado en servidor específico por dispositivo;
• salida de membresía mostrada de forma anónima;
• precios que cambian según el segmento de visitantes;
• pruebas A/B realizadas en PHP;
• sistemas de consentimiento que renderizan HTML de servidor materialmente diferente;
• carritos, listas de deseos o sesiones personalizados fuera de las cookies reconocidas de WordPress/WooCommerce.

Dichas páginas pueden necesitar una exclusión explícita de caché o un fragmento privado en el lado del cliente.

WooCommerce en sí no es obligatorio. Cuando está presente, las cookies reconocidas de sesión y carrito de WooCommerce evitan la entrega de HTML estático, pero los recorridos de pago y cuenta siguen requiriendo una prueba de extremo a extremo.

Otros servidores web

El plugin incluye reglas de Apache. Un despliegue con Nginx u otro servidor necesita una configuración equivalente escrita y revisada para ese entorno. La entrega temprana de PHP puede ser útil durante el diagnóstico, pero no convierte la integración de Apache proporcionada en una configuración verificada para otro servidor.

Decisión previa a la instalación

Procede cuando se cumpla todo lo siguiente:

• se conoce el propietario actual de advanced-cache.php;
• los enlaces permanentes personalizados están activos;
• PHP puede escribir y el servidor web puede leer el directorio de caché;
• el origen tiene un plan de entrega Apache revisado o equivalente;
• las páginas anónimas son adecuadas para el almacenamiento en caché compartido;
• un administrador—o un administrador de red en multisitio—puede gestionar la licencia y la configuración;
• existe una copia de reversión de wp-config.php, .htaccess y del drop-in anterior.

Luego sigue Install and activate POM Cache.