Cache Warmup für TYPO3

Warum die ersten 5 Minuten nach einem TYPO3-Deployment über die User Experience entscheiden

Nach jedem Deployment wird der TYPO3-Cache geleert. Das ist technisch notwendig, hat aber eine spürbare Konsequenz: Die ersten Besucher nach dem Deployment sehen ungecachte Seiten. Statt 200ms Ladezeit warten sie 2 bis 5 Sekunden, bei komplexen Seiten auch länger. Bei einem Deployment um 9:00 Uhr morgens trifft das genau die Besucher mit der höchsten Conversion-Wahrscheinlichkeit.

warmup löst dieses Problem, indem es den Cache proaktiv füllt, bevor der erste echte Besucher die Seite aufruft. Die Extension crawlt alle Seiten der Website im Hintergrund, basierend auf der Sitemap, und priorisiert dabei die meistbesuchten Seiten. Nach 2 bis 10 Minuten (abhängig von der Seitenzahl) ist der gesamte Cache gefüllt, und jeder Besucher bekommt die volle Performance.

Typische Einsatzszenarien

Automatisiertes Cache-Warming nach CI/CD-Deployments. Ein Unternehmen deployt seine TYPO3-Website 2 bis 3 Mal pro Woche über eine CI/CD-Pipeline (GitLab CI, GitHub Actions, Deployer). Nach jedem Deployment leert Deployer den Cache. warmup wird als letzter Schritt in der Pipeline aufgerufen und füllt den Cache, bevor das Deployment als “erfolgreich” gilt. Die Pipeline wartet, bis warmup fertig ist, und gibt erst dann den Traffic auf die neue Version frei.

Cache-Rebuild nach manuellen Änderungen. Redakteure leeren manchmal den gesamten Cache über das TYPO3-Backend, weil eine einzelne Seite nicht aktuell angezeigt wird. Das betrifft dann alle Seiten. warmup registriert sich als Hook auf das Cache-Clear-Event und startet automatisch den Warmup-Prozess. Der Redakteur merkt davon nichts, aber die Besucher spüren keinen Performance-Einbruch.

Geplantes Warming für High-Traffic-Zeitfenster. Ein Online-Shop auf TYPO3-Basis hat seine Spitzenzeiten zwischen 10:00 und 12:00 Uhr. Ein Scheduler-Task startet warmup täglich um 9:30 Uhr, damit der Cache pünktlich zum Traffic-Peak vollständig gefüllt ist. Das ist besonders relevant, wenn der TYPO3-Cache eine begrenzte TTL (Time-to-Live) hat und über Nacht teilweise abläuft.

Technische Architektur

warmup arbeitet als TYPO3-CLI-Command und als Scheduler-Task. Der Warmup-Prozess läuft in drei Phasen:

• URL-Sammlung: warmup liest die Sitemap der Website (sitemap.xml) und extrahiert alle URLs. Alternativ kann ein Crawler die Sitemap aus dem TYPO3-Seitenbaum generieren, falls keine Sitemap-Extension konfiguriert ist. Die URL-Liste kann über Konfiguration gefiltert werden (z.B. nur bestimmte Seitenbäume oder Sprachen).
• Priorisierung: URLs werden nach Priorität sortiert. Die Priorität kann aus der Sitemap (<priority>-Tag), aus Matomo/Analytics-Daten oder aus einer manuellen Konfiguration stammen. Die Startseite und die Top-10-Landingpages werden zuerst gecacht.
• Crawling: warmup ruft jede URL per HTTP-Request auf. Der TYPO3-Caching-Framework speichert das Rendering-Ergebnis. warmup unterstützt paralleles Crawling (konfigurierbar, Standard: 4 gleichzeitige Requests), um den Prozess zu beschleunigen, ohne den Server zu überlasten.

Der CLI-Command lautet vendor/bin/typo3 warmup:execute. Für die CI/CD-Integration wird er typischerweise als Post-Deploy-Hook aufgerufen.

Abhängigkeiten: TYPO3 Core, Caching Framework. warmup arbeitet mit jedem Cache-Backend zusammen - Dateisystem, Redis, Memcached, APCu. In Kombination mit staticfilecache erzeugt warmup vorab statische HTML-Dateien, die vom Webserver direkt ausgeliefert werden. Die Extension bietet zudem einen Dry-Run-Modus, der die URL-Liste anzeigt, ohne Requests auszuführen. Das ist nützlich, um die Warmup-Konfiguration zu überprüfen, bevor der erste produktive Lauf startet.

Häufige Probleme und Lösungen

Problem: warmup-Prozess dauert über 30 Minuten. Bei Websites mit mehr als 5.000 Seiten und Multi-Language-Setup (z.B. 1.000 Seiten x 5 Sprachen = 5.000 URLs) kann der Warmup-Prozess lang dauern. Die Lösung: Parallelität erhöhen (z.B. auf 8 gleichzeitige Requests), unwichtige Seiten ausschliessen (z.B. Paginierungsseiten, Tag-Archive) und den Prozess auf die Top-500-Seiten beschränken. Die restlichen Seiten werden beim ersten Besuch gecacht.

Problem: Server-Load steigt während des Warmups auf 100%. warmup erzeugt reale HTTP-Requests gegen den eigenen Server. Ohne Rate-Limiting kann das die Serverlast auf ein Niveau treiben, das echte Besucher ausbremst. Die Lösung: Parallelität reduzieren und ein Delay zwischen Requests konfigurieren (z.B. 100ms). Auf dedizierten Servern mit ausreichend Ressourcen ist das kein Problem; auf Shared Hosting kann warmup den Server des Providers triggern.

Problem: Gecachte Seiten sind nach dem Warmup nicht aktuell. warmup cached die Seite so, wie sie zum Zeitpunkt des Aufrufs existiert. Wenn Redakteure während des Warmup-Prozesses Content ändern, stimmt der Cache nicht mit dem aktuellen Stand überein. Die Lösung: Warmup erst starten, nachdem alle Content-Änderungen abgeschlossen sind. In CI/CD-Pipelines ist das automatisch der Fall, bei manuellen Cache-Clears sollte der Warmup mit 30 Sekunden Verzögerung starten.

Migration und Versions-Kompatibilität

Die warmup-Extension (eliashaeussler/typo3-warming) ist für TYPO3 v11 und v12 LTS verfügbar und wird aktiv gepflegt. Für TYPO3 v13 wird die Kompatibilität zeitnah nach dem Release erwartet.

Wer bisher manuelle Warmup-Scripte nutzt (curl-Schleifen, wget-Crawler), kann diese durch warmup ersetzen. Der Vorteil: warmup kennt die TYPO3-Sitemap-Struktur, priorisiert nach Traffic und integriert sich in den Scheduler. Ein manuelles Script crawlt blind, warmup crawlt intelligent.

Die Kombination warmup + staticfilecache + Redis ist der Performance-Stack, den Gosign für Enterprise-TYPO3-Installationen empfiehlt. warmup füllt den Cache, staticfilecache serviert statische HTML-Dateien ohne PHP, Redis speichert Datenbank-Queries. Zusammen erreichen TYPO3-Websites damit Ladezeiten unter 100ms. Für Websites mit weniger als 500 Seiten und moderatem Traffic reicht warmup allein ohne staticfilecache aus. Der einfache TYPO3-Page-Cache liefert bereits Ladezeiten unter 300ms, wenn er korrekt gefüllt ist. warmup stellt sicher, dass dieses Niveau von der ersten Sekunde nach dem Deployment an gehalten wird.