Cache Warmup para TYPO3

Por qué los primeros 5 minutos tras un despliegue TYPO3 deciden la experiencia de usuario

Tras cada despliegue se vacía el caché de TYPO3. Eso es técnicamente necesario, pero tiene una consecuencia palpable: los primeros visitantes tras el despliegue ven páginas sin caché. En lugar de 200 ms de carga, esperan de 2 a 5 segundos, en páginas complejas incluso más. Con un despliegue a las 9:00 de la mañana, eso afecta exactamente a los visitantes con mayor probabilidad de conversión.

warmup resuelve este problema llenando el caché de forma proactiva antes de que llegue el primer visitante real. La extensión rastrea todas las páginas de la web en segundo plano, basándose en el sitemap, y prioriza las páginas más visitadas. Tras 2 a 10 minutos (según el número de páginas), todo el caché está lleno y cada visitante obtiene el rendimiento completo.

Escenarios de uso habituales

Cache warming automático tras despliegues CI/CD. Una empresa despliega su web TYPO3 de 2 a 3 veces por semana vía pipeline CI/CD. Tras cada despliegue, Deployer vacía el caché. warmup se ejecuta como último paso en la pipeline y llena el caché antes de que el despliegue se considere “exitoso”.

Reconstrucción del caché tras cambios manuales. Los editores a veces vacían todo el caché desde el backend TYPO3 porque una página no se muestra actualizada. warmup se registra como hook en el evento de vaciado de caché y arranca automáticamente el proceso de warmup. El editor no se da cuenta, pero los visitantes no experimentan caída de rendimiento.

Warming programado para picos de tráfico. Una tienda online basada en TYPO3 tiene sus picos entre las 10:00 y las 12:00. Una tarea del Scheduler arranca warmup diariamente a las 9:30 para que el caché esté completamente lleno a tiempo para el pico de tráfico.

Arquitectura técnica

warmup funciona como comando CLI de TYPO3 y como tarea del Scheduler. El proceso trabaja en tres fases: recopilación de URLs (warmup lee el sitemap.xml y extrae todas las URLs), priorización (las URLs se ordenan por prioridad desde el sitemap, datos de analytics o configuración manual) y crawling (warmup llama a cada URL vía petición HTTP; soporta crawling paralelo, configurablemente con 4 peticiones simultáneas por defecto).

El comando CLI es vendor/bin/typo3 warmup:execute. warmup funciona con cualquier backend de caché - sistema de archivos, Redis, Memcached, APCu. En combinación con staticfilecache, warmup genera previamente archivos HTML estáticos que el servidor web sirve directamente.

Problemas frecuentes y soluciones

El proceso de warmup dura más de 30 minutos. Con webs de más de 5.000 páginas y configuración multi-idioma (por ejemplo, 1.000 páginas x 5 idiomas = 5.000 URLs), el warmup puede tardar. Solución: aumentar el paralelismo (por ejemplo, a 8 peticiones simultáneas), excluir páginas poco importantes (paginación, archivos de tags) y limitar el proceso a las 500 páginas principales.

La carga del servidor sube al 100 % durante el warmup. warmup genera peticiones HTTP reales contra el propio servidor. Sin limitación de velocidad, la carga del servidor puede llegar a niveles que frenen a visitantes reales. Solución: reducir el paralelismo y configurar un retardo entre peticiones (por ejemplo, 100 ms).

Las páginas cacheadas no están actualizadas tras el warmup. warmup cachea la página tal como existe en el momento de la llamada. Si los editores modifican contenido durante el proceso de warmup, el caché no coincide con el estado actual. Solución: iniciar el warmup solo después de completar todos los cambios de contenido.

Migración y compatibilidad de versiones

La extensión warmup (eliashaeussler/typo3-warming) está disponible para TYPO3 v11 y v12 LTS y se mantiene activamente. Quien hasta ahora usa scripts de warmup manuales (bucles curl, crawlers wget) puede sustituirlos por warmup, con la ventaja de que conoce la estructura del sitemap TYPO3, prioriza por tráfico y se integra en el Scheduler.

La combinación warmup + staticfilecache + Redis es el stack de rendimiento que Gosign recomienda para instalaciones TYPO3 enterprise. warmup llena el caché, staticfilecache sirve archivos HTML estáticos sin PHP, Redis almacena queries de base de datos. En conjunto, las webs TYPO3 alcanzan tiempos de carga por debajo de 100 ms.