Cache Warmup dla TYPO3

Dlaczego pierwsze 5 minut po wdrożeniu TYPO3 decyduje o doświadczeniu użytkownika

Po każdym wdrożeniu cache TYPO3 jest czyszczony. To technicznie konieczne, ale ma odczuwalną konsekwencję: pierwsi odwiedzający po wdrożeniu widzą niecachowane strony. Zamiast 200 ms czasu ładowania czekają 2 do 5 sekund, przy złożonych stronach jeszcze dłużej. Przy wdrożeniu o 9:00 rano dotyczy to dokładnie odwiedzających o najwyższym prawdopodobieństwie konwersji.

warmup rozwiązuje ten problem, proaktywnie wypełniając cache, zanim pierwszy prawdziwy odwiedzający wywoła stronę. Rozszerzenie wywołuje wszystkie strony witryny z drzewa stron, we wszystkich językach, a strony chronione dla każdej grupy użytkowników. Po 2 do 10 minutach (w zależności od liczby stron) cały cache jest wypełniony i każdy odwiedzający dostaje pełną wydajność.

Typowe scenariusze zastosowań

Automatyczne rozgrzewanie cache po wdrożeniach CI/CD. Firma wdraża swoją witrynę TYPO3 2 do 3 razy tygodniowo przez pipeline CI/CD. Po każdym wdrożeniu Deployer czyści cache. warmup jest wywoływane jako ostatni krok w pipeline i wypełnia cache, zanim wdrożenie zostanie uznane za “udane”.

Odbudowa cache po ręcznych zmianach. Redaktorzy czasem czyszczą cały cache przez backend TYPO3, bo pojedyncza strona nie wyświetla się aktualnie. To dotyczy wtedy wszystkich stron. Zadanie Scheduler może regularnie uruchamiać warmup i ponownie wypełniać cache; własnego hooka na zdarzenie czyszczenia cache warmup nie ma.

Planowane rozgrzewanie dla okien o dużym ruchu. Sklep online na TYPO3 ma szczyty ruchu między 10:00 a 12:00. Zadanie Scheduler uruchamia warmup codziennie o 9:30, by cache był kompletnie wypełniony na czas szczytu ruchu.

Architektura techniczna

warmup działa jako komenda TYPO3 CLI i zadanie Scheduler. Proces rozgrzewania przebiega w trzech fazach: zbieranie URL (warmup odczytuje wszystkie strony z tabeli pages i tworzy ich URL przez routing konfiguracji Site), cache rootline (w standardowym przebiegu warmup najpierw buduje cache rootline wszystkich stron) i rendering (warmup renderuje każdą stronę w symulowanym żądaniu frontendowym w tym samym procesie PHP, bez wywołania HTTP, a TYPO3 Caching Framework zapisuje wynik renderingu).

Komenda CLI brzmi vendor/bin/typo3 cache:warmupPages; z argumentem rootline lub pages rozgrzewa tylko część. Dla integracji CI/CD jest wywoływana typowo jako Post-Deploy-Hook. warmup współpracuje z każdym backendem cache - system plików, Redis, Memcached, APCu. W połączeniu ze staticfilecache warmup generuje z góry statyczne pliki HTML serwowane bezpośrednio przez serwer webowy.

Częste problemy i rozwiązania

Proces warmup trwa ponad 30 minut. Przy witrynach z ponad 5000 stronami i ustawieniu wielojęzycznym proces może trwać długo. Rozwiązanie: ograniczenie przebiegu komendą cache:warmupPages rootline do cache rootline, który bez renderowania stron kończy się znacznie szybciej.

Obciążenie serwera rośnie do 100% podczas warmup. warmup renderuje każdą stronę w procesie CLI na własnym serwerze. Bez rate-limiting może to doprowadzić obciążenie serwera do poziomu spowalniającego prawdziwych odwiedzających. Rozwiązanie: przeniesienie przebiegu zadaniem Scheduler na godziny o małym ruchu.

Cachowane strony po warmup nie są aktualne. warmup cachuje stronę taką, jaka istnieje w momencie wywołania. Jeśli redaktorzy zmieniają treść podczas procesu warmup, cache nie zgadza się z aktualnym stanem. Rozwiązanie: uruchomienie warmup dopiero po zakończeniu wszystkich zmian treści.

Migracja i kompatybilność wersji

Rozszerzenie warmup pochodzi od b13 (b13/warmup) i jest aktywnie utrzymywane: wersja 3.0.0 z 23.09.2026 wspiera TYPO3 v12, v13 i v14. Alternatywą opartą na sitemapie jest rozszerzenie Warming Eliasa Häußlera (eliashaeussler/typo3-warming).

Kombinacja warmup + staticfilecache + Redis to stos wydajnościowy, który Gosign zaleca dla instalacji TYPO3 klasy enterprise. warmup wypełnia cache, staticfilecache serwuje statyczne pliki HTML bez PHP, Redis przechowuje zapytania bazodanowe. Razem witryny TYPO3 osiągają czasy ładowania poniżej 100 ms. Dla witryn z mniej niż 500 stronami i umiarkowanym ruchem wystarczy sam warmup. Prosty TYPO3 Page Cache dostarcza już czasy ładowania poniżej 300 ms, gdy jest prawidłowo wypełniony. warmup zapewnia, że ten poziom jest utrzymywany od pierwszej sekundy po wdrożeniu.