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 crawluje wszystkie strony witryny w tle, na podstawie sitemapy, priorytetyzując najczęściej odwiedzane strony. 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. warmup rejestruje się jako hook na zdarzenie czyszczenia cache i automatycznie uruchamia proces rozgrzewania.

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 sitemapę strony i wyciąga wszystkie URL), priorytetyzacja (URL są sortowane według priorytetu z sitemapy, danych Matomo/Analytics lub ręcznej konfiguracji) i crawling (warmup wywołuje każdy URL przez żądanie HTTP, a TYPO3 Caching Framework zapisuje wynik renderingu).

Komenda CLI brzmi vendor/bin/typo3 warmup:execute. 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: zwiększenie równoległości, wykluczenie nieistotnych stron (strony paginacji, archiwa tagów) i ograniczenie procesu do Top-500 stron.

Obciążenie serwera rośnie do 100% podczas warmup. warmup generuje prawdziwe żądania HTTP wobec własnego serwera. Bez rate-limiting może to doprowadzić obciążenie serwera do poziomu spowalniającego prawdziwych odwiedzających. Rozwiązanie: zmniejszenie równoległości i konfiguracja opóźnienia między żądaniami.

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 (eliashaeussler/typo3-warming) jest dostępne dla TYPO3 v11 i v12 LTS i jest aktywnie utrzymywane. Kompatybilność z TYPO3 v13 jest oczekiwana wkrótce po wydaniu.

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.