Cache Warmup para TYPO3

Por que os primeiros 5 minutos após um deploy TYPO3 definem a experiência do usuário

Após cada deployment, o cache TYPO3 é limpo. Isso é tecnicamente necessário, mas tem uma consequência perceptível: os primeiros visitantes após o deployment veem páginas sem cache. Em vez de 200ms de tempo de carregamento, esperam 2 a 5 segundos, em páginas complexas até mais. Em um deployment às 9h da manhã, isso atinge exatamente os visitantes com maior probabilidade de conversão.

warmup resolve esse problema preenchendo o cache proativamente, antes que o primeiro visitante real acesse a página. A extensão chama todas as páginas do site a partir da árvore de páginas, em todos os idiomas e, nas páginas protegidas, por grupo de usuários. Após 2 a 10 minutos (dependendo do número de páginas), todo o cache está preenchido e cada visitante recebe a performance completa.

Cenários típicos de uso

Cache warming automatizado após deploys CI/CD. Uma empresa faz deploy do seu site TYPO3 2 a 3 vezes por semana via pipeline CI/CD. Após cada deployment, o Deployer limpa o cache. warmup é chamado como último passo na pipeline e preenche o cache antes que o deployment seja considerado “bem-sucedido”.

Rebuild de cache após limpezas manuais. Editores às vezes limpam todo o cache pelo backend TYPO3 porque uma única página não está atualizada. Isso afeta todas as páginas. Uma tarefa scheduler pode iniciar o warmup regularmente e voltar a preencher o cache; o warmup não traz um hook próprio para o evento de limpeza de cache.

Warming programado para janelas de alto tráfego. Uma loja online em TYPO3 tem seus picos de tráfego entre 10h e 12h. Uma tarefa scheduler inicia warmup diariamente às 9h30, para que o cache esteja completamente preenchido a tempo do pico de tráfego.

Arquitetura técnica

warmup funciona como comando CLI TYPO3 e como tarefa scheduler. O processo de warmup ocorre em três fases: coleta de URLs (warmup lê todas as páginas da tabela pages e gera as URLs pelo roteamento da configuração do site), cache de rootline (na execução padrão, o warmup primeiro monta o cache de rootline de todas as páginas) e renderização (warmup renderiza cada página em um request de frontend simulado no mesmo processo PHP, sem chamada HTTP, uma página após a outra).

O comando CLI é vendor/bin/typo3 cache:warmupPages; com o argumento rootline ou pages, ele aquece apenas uma parte. Para integração CI/CD, é tipicamente chamado como hook post-deploy.

Dependências: TYPO3 Core, Caching Framework. warmup funciona com qualquer backend de cache - sistema de arquivos, Redis, Memcached, APCu. Em combinação com staticfilecache, warmup gera previamente arquivos HTML estáticos que são servidos diretamente pelo servidor web.

Problemas frequentes e soluções

Processo de warmup demora mais de 30 minutos. Em sites com mais de 5.000 páginas e setup multi-idioma (ex: 1.000 páginas x 5 idiomas = 5.000 URLs), o warmup pode demorar. Solução: limitar a execução ao cache de rootline com cache:warmupPages rootline, que termina bem mais rápido sem renderizar páginas.

Carga do servidor sobe para 100% durante o warmup. warmup renderiza cada página no processo CLI do próprio servidor. Sem rate-limiting, a carga pode subir a ponto de frear visitantes reais. Solução: agendar a execução com uma tarefa scheduler em horários de pouco tráfego.

Páginas cacheadas não estão atualizadas após o warmup. warmup cacheia a página como ela existe no momento da chamada. Se editores alteram conteúdo durante o warmup, o cache não corresponde ao estado atual. Solução: iniciar warmup apenas após todas as alterações de conteúdo estarem concluídas.

Migração e compatibilidade de versões

A extensão warmup é da b13 (b13/warmup) e é mantida ativamente: a versão 3.0.0 de 23/09/2026 suporta TYPO3 v12, v13 e v14. A alternativa baseada em sitemap é a extensão Warming, de Elias Häußler (eliashaeussler/typo3-warming).

Quem até agora usa scripts de warmup manuais (loops curl, crawlers wget) pode substituí-los por warmup. A vantagem: warmup conhece a árvore de páginas do TYPO3, com idiomas e grupos de usuários, e pode ser iniciado pelo scheduler.

A combinação warmup + staticfilecache + Redis é o stack de performance que a Gosign recomenda para instalações TYPO3 enterprise. warmup preenche o cache, staticfilecache serve arquivos HTML estáticos sem PHP, Redis armazena queries de banco de dados. Juntos, sites TYPO3 alcançam tempos de carregamento abaixo de 100ms.