Instala y verifica el drop-in de caché avanzada
advanced-cache.php es un drop-in del núcleo de WordPress. WordPress carga ese nombre de archivo exacto cerca del inicio de una petición cuando WP_CACHE está habilitado. POM Cache lo usa para buscar un archivo estático antes del arranque normal de plugins y del tema.
POM Cache informa del estado de despliegue requerido, pero nunca edita wp-config.php y nunca crea, sobrescribe ni elimina el drop-in.
Archivos y constantes implicados
La fuente suministrada por el plugin es:
wp-content/plugins/pom-cache/pom-cache-advanced-cache.phpEl nombre de archivo desplegado en WordPress debe ser:
wp-content/advanced-cache.phpLos valores estándar de wp-config.php son:
define( 'WP_CACHE', true );
define( 'POM_CACHE_HOME', WP_CONTENT_DIR . '/plugins/pom-cache/' );POM_CACHE_HOME debe terminar con una barra inclinada y coincidir con el directorio real de instalación de POM Cache. Es necesaria porque el drop-in se ejecuta demasiado pronto para descubrir el plugin mediante la lista de plugins activos de WordPress.
Inspecciona antes de reemplazar nada
- Abre POM Cache → Advanced → WordPress configuration.
- Lee el tipo y la ruta detectados en Drop-in.
- Si
wp-content/advanced-cache.phpya existe pero no se reconoce como POM Cache, detente. - Identifica qué plugin o servicio de alojamiento es el propietario del archivo existente.
- Planifica la migración o el acuerdo de compatibilidad con ese propietario.
WordPress solo admite un archivo en esta ruta de drop-in. Sobrescribir a ciegas el archivo de otro plugin de caché puede romper su funcionamiento y dejar reglas de reescritura mezcladas o archivos obsoletos.
Despliega la fuente de POM Cache
Usa el proceso de despliegue de archivos de tu proveedor de alojamiento para copiar la fuente suministrada a la ruta de drop-in de WordPress. Conserva una copia de seguridad recuperable de cualquier archivo previo conocido como parte de ese despliegue.
Después edita wp-config.php mediante el proceso normal de gestión de configuración y añade las dos constantes antes de la línea de «stop editing» de WordPress. No definas ninguna de las dos constantes dos veces.
Si el plugin está instalado en una ubicación distinta de wp-content/plugins/pom-cache/, usa esa ruta absoluta del plugin para POM_CACHE_HOME.
Lee el informe de estado
Actualiza Advanced → WordPress configuration. El informe comprueba:
| Elemento de estado | Qué significa OK |
|---|---|
| Drop-in | El archivo instalado coincide con la fuente de POM Cache esperada por esta versión del plugin |
| POM_CACHE_HOME | La ruta detectada coincide con el directorio del plugin instalado |
| WP_CACHE | El valor detectado es el booleano true |
El informe también muestra los valores esperados y detectados. Needs manual change no es un botón de acción; corrige la fuente de despliegue y luego actualiza.
Verifica la ejecución
- Habilita General → Runtime → Caching.
- Borra la caché HTML del sitio actual.
- Solicita una vez una página pública sencilla sin haber iniciado sesión.
- Confirma que se genera un archivo HTML.
- Solicita de nuevo la misma URL sin que las reglas directas de Apache tengan prioridad.
- Inspecciona la respuesta buscando:
X-POM-Cache: Served static cache from PHP; phase=earlyEsa cabecera demuestra que el drop-in encontró y sirvió el archivo. Si Apache ya gestiona la petición, usa temporalmente el método de verificación seguro de origen/PHP del despliegue; no concluyas que el drop-in está roto solo porque la respuesta de Apache carezca de la cabecera.
Problemas de estado habituales
El drop-in falta
Copia pom-cache-advanced-cache.php a wp-content/advanced-cache.php mediante el despliegue. Activar el plugin no realiza esta copia.
El tipo detectado pertenece a otro producto
No lo sobrescribas. Elimina o migra por completo el sistema de caché anterior, incluidas sus reglas de servidor, solo después de confirmar la propiedad.
WP_CACHE es false o no está definido
Defínelo una vez como el booleano true, no como la cadena "true".
POM_CACHE_HOME apunta a una ruta de una versión antigua
Actualízalo al directorio actual del plugin instalado y conserva la barra inclinada final.
El informe es correcto pero no se produce ninguna entrega temprana
Comprueba el ajuste de tiempo de ejecución, las cookies de la petición, la cadena de consulta, el método, la elegibilidad de la URL, la ruta del archivo y los permisos del sistema de archivos. Usa Understand early cache delivery para conocer la secuencia exacta de decisión.