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 crawla todas as páginas do site em segundo plano, baseada no sitemap, priorizando as páginas mais visitadas. 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. warmup se registra como hook no evento de limpeza de cache e inicia automaticamente o processo de warmup.

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ê o sitemap.xml do site e extrai todas as URLs), priorização (URLs são ordenadas por prioridade - da tag priority do sitemap, dados de analytics ou configuração manual) e crawling (warmup chama cada URL via request HTTP com crawling paralelo configurável, padrão: 4 requests simultâneos).

O comando CLI é vendor/bin/typo3 warmup:execute. 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: aumentar paralelismo, excluir páginas pouco importantes e limitar o processo às top 500 páginas.

Carga do servidor sobe para 100% durante o warmup. warmup gera requests HTTP reais contra o próprio servidor. Sem rate-limiting, a carga pode subir a ponto de frear visitantes reais. Solução: reduzir paralelismo e configurar delay entre requests.

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 (eliashaeussler/typo3-warming) está disponível para TYPO3 v11 e v12 LTS e é mantida ativamente. Para TYPO3 v13, a compatibilidade é esperada logo após o release.

Quem até agora usa scripts de warmup manuais (loops curl, crawlers wget) pode substituí-los por warmup. A vantagem: warmup conhece a estrutura do sitemap TYPO3, prioriza por tráfego e se integra ao 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.