Administrar el caché de DreamPress con el plugin Nginx Helper

El plugin Nginx Helper se configura automáticamente con todos los sitios DreamPress. Este plugin ayuda a evitar inconvenientes como la inhabilidad de ver los cambios guardados o mostrar contenido desactualizado a los visitantes.

Este artículo explica cómo usar las herramientas de caché del plugin en tu sitio DreamPress.

Métodos de caché

Nginx Helper provee dos opciones de caché.

• nginx Fastcgi cache: Administra las configuraciones externas de Nginx
• Redis cache: Esta funcionalidad no está disponible en DreamPress

1. Inicia sesión en tu sitio WordPress en example.com/wp-login.php.
2. En el menú de la izquierda, navega a Plugins > Añadir Nuevo.
3. Busca Nginx Helper.
4. Haz clic en los botones Instalar Ahora y Activar.

   Si el botón Activar está deshabilitado, navega a la página Plugins > Plugins Instalados. Confirma que el plugin esté listado aquí y activo.

El plugin se configura automáticamente por tí, no hay necesidad de ajustar nada más.

Sobrescribir el plugin

Es posible que este plugin haya sido sobrescrito en algún momento. Las siguientes acciones puede que lo hayan causado:

• Migrar un sitio WordPress desde otra compañía de alojamiento a DreamPress
• Subir un sitio WordPress desde tu computador a DreamPress

Si el plugin se elimina, siempre puedes instalarlo de nuevo en el panel de WordPress.

El plugin Nginx Helper te brinda un control detallado sobre la administración y eliminación del caché de tu sitio, así como acceso a opciones de configuración de depuración.

Para acceder a la pantalla de configuraciones:

1. Inicia sesión en tu sitio WordPress en example.com/wp-login.php.
2. En el menú de la izquierda selecciona Configuraciones > Nginx Helper.
3. En la sección Debug Options, selecciona las casillas:
   • Enable Logging
   • Enable Nginx Timestamp in HTML
4. Haz clic en Save All Changes para guardar los nuevos ajustes.

Habilitar el registro de errores

Esta configuración crea un archivo de registro que contiene los eventos más recientes de acciones como borrar caché, advertencias, y mensajes de error. Este archivo de registro se encuentra en el siguiente directorio:

example.com/wp-content/uploads/nginx-helper/nginx.log

Habilitar las marcas de tiempo de Nginx en HTML

Esta configuración crea un comentario oculto al final de cada página. Este contiene:

• La fecha
• Número de consultas
• El tiempo que toma para generar una versión estática del sitio web

Puedes ver este comentario oculto revisando el código fuente de la página en tu navegador.

• Windows: Ctrl + U
• Mac: Option + CMD + U

Desplázate hacia abajo hasta la última línea en la parte inferior del código HTML para ver esta información. Aparecerá así:

<!--Cached using Nginx-Helper on 2023-10-17 15:20:14. It took 12 queries executed in 0.289 seconds.-->

Los siguientes comandos de SSH te permiten probar el caché de tu sitio.

Usa curl -I para probar la URL de tu sitio web. Esto puede ser la versión www o non-www de tu sitio web.

• https://example.com
• https://www.example.com

Cualquier URL de tu sitio que uses, asegúrate de correr el comando al menos dos veces. Por ejemplo:

[server]$ curl -I https://example.com

Leer las respuestas

Este comando responde con varios Encabezados de HTTP. Aquí estamos buscando el encabezado x-cache-status.

Si es hit en el segundo intento, la página hace caché como se espera. Por ejemplo:

[server]$ curl -I https://example.com
HTTP/2 200
server: nginx
date: Tue, 09 Apr 2024 16:48:49 GMT
content-type: text/html; charset=UTF-8
vary: Accept-Encoding
vary: Accept-Encoding, Cookie
cache-control: max-age=3, must-revalidate
strict-transport-security: max-age=31536000;
x-cache-status: MISS

[server]$ curl -I https://example.com
HTTP/2 200
server: nginx
date: Tue, 09 Apr 2024 16:48:49 GMT
content-type: text/html; charset=UTF-8
vary: Accept-Encoding
vary: Accept-Encoding, Cookie
cache-control: max-age=3, must-revalidate
strict-transport-security: max-age=31536000;
x-cache-status: HIT

Usar el plugin

Purgar TODO el caché

1. Inicia sesión en tu sitio WordPress en example.com/wp-login.php.
2. En el menú de la izquierda selecciona Configuraciones > Nginx Helper.
3. En la parte superior derecha, da clic al botón Purge Entire Cache.

Purgar una sola página o publicación

Una mejor alternativa es purgar el caché selectivamente de una página o publicación específica. Puedes purgar los mismos usando el botón Purge Cache del plugin cuando veas la página en vivo.

To purge cache for an individual page or post:

1. Inicia sesión en tu sitio WordPress en example.com/wp-login.php.
2. Navega a la página o publicación que quieres purgar el caché.
3. Haz clic en el enlace View debajo de el título para abrir la URL pública.
4. En la barra de herramientas de la parte superior, haz clic en Purge current Page.

   La página se recarga, y la publicación o la página se purga del caché.

Usar SSH

Inicia sesión en tu sitio web a través de SSH para correr los siguientes comandos.

Purgar TODO el caché

Esto purga el caché de tu sitio web completamente.

[server]$ curl -X PURGE -D - https://example.com/*

Purgar el caché de una sola página

Esto purga el caché de una página en específico.

[server]$ curl -X PURGE -D - https://example.com/page1

Si el plugin Nginx Helper parece no funcionar, hay varias cosas que puedes robar.

Eliminar la carpeta /cache

Si tu sitio web usa plugins de caché adicionales, elimina el contenido de la carpeta /wp-content/cache.

Deshabilita Proxy Services

Los servicios de proxy como Cloudflare pueden provocar falsos positivos con el almacenamiento en caché de páginas. DreamHost recomienda deshabilitar temporalmente cualquier servicio de proxy al solucionar problemas con el almacenamiento en caché de tu servidor.

Cambiar a un tema predeterminado

La primera cosa y la más sencilla de es revisar el tema de tu sitio.

1. Inicia sesión en tu sitio WordPress en example.com/wp-login.php.
2. En el menú de la izquierda, navega a Apariencia > Temas.
3. Cambia el tema activo a uno predeterminado (como twentytwentythree).
4. Prueba el caché otra vez.

Deshabilitar tus plugins

Usa los pasos a continuación para probar los plugins activos de tu sitio.

1. Asegúrate de haber habilitado las configuraciones de caché Enable Logging y Enable Nginx Timestamp in HTML como se explica arriba.
2. Deshabilitar todos los plugins excepto Nginx Helper.
3. Purga el caché usando el plugin o a través de SSH.
4. Visita tu sitio web en un buscador.
5. Carga en un buscador la página que quieres arreglar.
6. Abre la fuente de la página y revisa la marca de tiempo de Nginx en el código de HTML.

Ubicar el plugin responsable

Si al deshabilitar los plugins el servicio de caché de tu sitio vuelve a funcionar, eso significa que hay un plugins que es la causa más probable de los problemas de caché.

Para determinar cual plugin es el responsable:

1. Renombra cada plugin, uno a la vez.
2. Purga el caché usando el plugin o a través de SSH.
3. Visita tu sitio web en un buscador.
4. Carga en un buscador la página que quieres arreglar.
5. Abre la fuente de la página y revisa la marca de tiempo de Nginx en el código de HTML.

Puedes saltar el caché en una sola página agregando ?nocache al final de la URL. Por ejemplo:

example.com/?nocache
example.com/sample-page/?nocache