Cache-Warmup mit der Extension „warming"

Was ist Cache-Warmup und warum braucht man ihn?

TYPO3 speichert gerenderte Seiten im Frontend-Cache, damit sie bei jedem weiteren Aufruf sofort ausgeliefert werden können, statt komplett neu aufgebaut zu werden. Nach jedem Cache-Clear – etwa nach einem Deployment, einer Content-Änderung oder einem geplanten Cache-Flush – ist dieser Cache jedoch leer. Die jeweils erste Anfrage an eine Seite trifft dann auf einen "kalten" Cache: TYPO3 muss die Seite komplett neu berechnen, was spürbar länger dauert.

Die Extension "warming" (eliashaeussler/typo3-warming) automatisiert genau diesen Vorgang: Sie liest die XML-Sitemap der Website aus, ruft jede darin gelistete URL aktiv auf und füllt so den Cache proaktiv, bevor echte Besucher oder Suchmaschinen-Crawler die Seiten aufrufen. Das funktioniert für ganze Websites anhand der Sitemap oder gezielt für einzelne Seiten anhand ihrer Seiten-ID, auch mehrsprachig.

Voraussetzungen und Installation

Die Extension wird wie üblich per Composer eingebunden:

Sie unterstützt PHP 8.2 bis 8.5 sowie TYPO3 13.4 LTS bis 14.3 LTS. Einzige inhaltliche Voraussetzung: Es muss mindestens eine XML-Sitemap vorhanden sein. Die bringt TYPO3 mit der Core-Extension seo ohnehin bereits mit, sodass in den meisten Projekten keine zusätzliche Einrichtung nötig ist.

Cache manuell oder automatisch vorwärmen

Für das eigentliche Aufwärmen bietet die Extension mehrere Wege an:

Backend-Toolbar und Seitenbaum: Ein Symbol in der Backend-Toolbar öffnet ein Warmup-Fenster für die gesamte Website; im Seitenbaum lässt sich derselbe Vorgang gezielt für eine einzelne Seite samt Unterseiten anstoßen – praktisch für Redakteur:innen nach größeren Änderungen, ganz ohne Konsolenzugriff.

Konsolen-Befehle: Für Entwickler und automatisierte Abläufe steht der Befehl warming:cachewarmup bereit, der wahlweise die komplette Sitemap oder einzelne Seiten-IDs abarbeitet. Der ergänzende Befehl warming:showuseragent zeigt den User-Agent, mit dem der Crawler unterwegs ist – hilfreich, um ihn z. B. in einer Firewall oder einem Sicherheits-Plugin gezielt zuzulassen.