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 llama a todas las páginas de la web desde el árbol de páginas, en todos los idiomas y, en las páginas protegidas, por grupo de usuarios. 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. Una tarea del Scheduler puede arrancar warmup con regularidad y volver a llenar la caché; warmup no trae un hook propio para el evento de vaciado de caché. El editor no se da cuenta, y tras la siguiente ejecución la caché vuelve a estar llena.

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 todas las páginas de la tabla pages y genera sus URLs con el routing de la configuración del sitio), caché de rootline (en la ejecución estándar, warmup construye primero la caché de rootline de todas las páginas) y renderizado (warmup renderiza cada página en una petición de frontend simulada dentro del mismo proceso PHP, sin llamada HTTP; procesa las páginas una tras otra, de modo que solo renderiza una a la vez).

El comando CLI es vendor/bin/typo3 cache:warmupPages; con el argumento rootline o pages solo calienta una parte. 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: limitar la ejecución a la caché de rootline con cache:warmupPages rootline, que termina mucho antes sin renderizar páginas.

La carga del servidor sube al 100 % durante el warmup. warmup renderiza cada página en el proceso CLI del propio servidor. Sin limitación de velocidad, la carga del servidor puede llegar a niveles que frenen a visitantes reales. Solución: programar la ejecución con una tarea del Scheduler en horas de poco tráfico.

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 es de b13 (b13/warmup) y se mantiene activamente: la versión 3.0.0 del 23.09.2026 soporta TYPO3 v12, v13 y v14. La alternativa basada en sitemap es la extensión Warming de Elias Häußler (eliashaeussler/typo3-warming). Quien hasta ahora usa scripts de warmup manuales (bucles curl, crawlers wget) puede sustituirlos por warmup, con la ventaja de que conoce el árbol de páginas de TYPO3 con idiomas y grupos de usuarios y puede arrancarse desde 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.