Aktualizacja TYPO3 do v14 Kompletny przewodnik migracji 2026

21 kwietnia 2026 roku – to data, którą powinien znać każdy administrator i właściciel strony opartej na TYPO3 CMS. Tego dnia ukaże się TYPO3 v14.3 LTS (Long Term Support) – wersja z gwarantowanym wsparciem bezpieczeństwa do połowy 2029 roku i opcją ELTS do 2033. Jednocześnie wsparcie dla TYPO3 v12 kończy się w kwietniu 2026, a v13 LTS otrzyma łatki bezpieczeństwa tylko do października 2027. Oznacza to, że dla tysięcy instalacji TYPO3 w Polsce i regionie DACH nadchodzi moment decyzji: zaktualizować teraz, zaplanować migrację na Q2 2026 – albo ryzykować pracę na niewspieranym systemie. 

Ten przewodnik przeprowadzi Cię przez cały proces aktualizacji TYPO3 do wersji 14 – od oceny gotowości Twojej obecnej instalacji, przez analizę breaking changes i kompatybilności rozszerzeń (extensions), aż po strategię testów i bezpieczny go-live. Niezależnie od tego, czy migrujesz z TYPO3 v12 czy v13 – znajdziesz tu konkretne kroki, narzędzia i rekomendacje oparte na doświadczeniu dziesiątek upgrade’ów przeprowadzonych przez nasz zespół. 

Dla firm planujących aktualizację TYPO3 kluczowe jest dobranie odpowiedniego momentu. Rekomendacja jest jednoznaczna: produktywne wdrożenia powinny startować najwcześniej od wersji 14.2 (feature freeze), a idealnie od 14.3 LTS, gdy Core i większość rozszerzeń są stabilne. Wcześniejsze wersje sprintowe (14.0, 14.1) są przeznaczone do testów na środowiskach deweloperskich – nie na produkcji. Ważna informacja dotycząca wsparcia: TYPO3 v14.3 LTS otrzyma poprawki błędów do końca 2027, łatki bezpieczeństwa do połowy 2029 i możliwość wykupienia ELTS (Extended Long Term Support) na kolejne 3–4 lata. To daje firmom z regionu DACH i Polski bezpieczeństwo planowania na perspektywę co najmniej trzech, a potencjalnie siedmiu lat. Jeśli Twoja strona działa na TYPO3 v11 lub starszym – regularne wsparcie już wygasło i aktualizacja TYPO3 powinna być priorytetem. 

Architektura lokalizacji została zmigrowana na Symfony Translation Component z obsługą XLIFF 1.2 i XLIFF 2.x, co znacząco usprawnia workflow tłumaczeń w stronach wielojęzycznych. Nowy kreator tłumaczeń prowadzi redaktorów krok po kroku przez proces, automatycznie pomijając kroki niewymagające decyzji. Na poziomie kodu TYPO3 v14 wymaga minimum PHP 8.2 (obsługuje 8.3, 8.4 i 8.5), wspiera bazy danych MySQL, MariaDB, PostgreSQL i SQLite. Composer stał się obowiązkowym narzędziem wdrażania – rozszerzenia bez pliku composer.json nie będą rozpoznawane nawet w trybie klasycznym. Usunięto TypoScriptFrontendController, kompresjsję HTTP z jądra (serwery Apache/Nginx realizują to wydajniej) oraz moduł Database Relations. Install Tool został w pełni zintegrowany z routingiem backendu – plik typo3/install.php nie jest już potrzebny. Modele i kontrolery Extbase obsługują teraz walidatory Symfony. To fundamentalne zmiany, które wymagają świadomego przygotowania. 

Jeśli działasz na TYPO3 v13 LTS – jesteś w najlepszej pozycji. Większość deprecjacji z v13 została już oznaczona w logach, a Extension Scanner w backendzie wskaże dokładnie, które fragmenty kodu wymagają aktualizacji. Upgrade do v14 jest bezpośredni i dobrze udokumentowany. Jeśli działasz na TYPO3 v12 LTS – wsparcie kończy się w kwietniu 2026. Rekomendowana ścieżka to v12 → v13 → v14 z uruchomieniem Upgrade Wizardów na każdym kroku. Można rozważyć bezpośredni skok v12 → v14, ale wymaga to ręcznej obsługi większej liczby breaking changes. Jeśli działasz na TYPO3 v11 lub starszym – regularne wsparcie już wygasło. Konieczna jest migracja etapowa (v11 → v12 → v13 → v14) lub rozważenie pełnego relaunchu strony na v14 LTS z wykorzystaniem nowoczesnej architektury Site Sets i Content Blocks. Narzędzia takie jak typo3-rector i Fractor automatyzują część zmian w kodzie, przyspieszając proces migracji. 

Procedura aktualizacji przez Composer przebiega w kilku krokach. Krok pierwszy: włącz log deprecjacji w obecnej wersji TYPO3 i pozwól mu zbierać dane przez kilka dni – ujawni przestarzałe wywołania API w Twoim kodzie. Krok drugi: uruchom Extension Scanner w backendzie (Admin Tools) – przeskanuje on Twoje rozszerzenia pod kątem użycia deprecated metod i wskaże, co wymaga aktualizacji. Krok trzeci: sprawdź kompatybilność każdego zainstalowanego rozszerzenia z v14 – na TER (TYPO3 Extension Repository) lub Packagist. Krok czwarty: uruchom wszystkie Upgrade Wizards obecnej wersji zanim przejdziesz wyżej. Krok piąty: zaktualizuj jądro TYPO3 poleceniem Composer (composer require typo3/cms-core:^14) i uruchom Upgrade Wizards nowej wersji – w v14 szczególnie ważna jest migracja zadań Schedulera, które zmieniają format. Krok szósty: uruchom Database Compare, aby wyrównać strukturę bazy danych. Krok siódmy: wyczyść cache i przetestuj stronę na środowisku stagingowym. 

Fluid 5 wprowadza trzy krytyczne breaking changes. Po pierwsze – sekcje CDATA w szablonach Fluid nie są już usuwane przez parser, lecz pełnią nową rolę: umożliwiają osadzanie inline CSS i JavaScript bez konfliktów z klamrami Fluid. Jeśli używałeś CDATA do komentowania kodu w szablonach – musisz zmienić podejście. Po drugie – nazwy zmiennych z prefiksem podkreślenia są zarezerwowane dla wewnętrznych przestrzeni nazw Fluid. Po trzecie – ViewHelpery zyskują ściślejszą walidację argumentów: typy niezgodne z API są odrzucane (choć Fluid automatycznie konwertuje proste typy). Ważne: TYPO3 13.4.21 już zapisuje ostrzeżenia deprecjacyjne w logach dla tych zmian – możesz sprawdzić kompatybilność swoich szablonów Fluid jeszcze przed migracją. Usunięcie TypoScriptFrontendController oznacza, że wszelkie bezpośrednie odwołania do tego obiektu w rozszerzeniach muszą zostać zrefaktoryzowane. Narzędzie typo3-rector oferuje gotowe reguły automatyzujące część tych zmian. Z kolei nowy format zadań Schedulera wymaga uruchomienia dedykowanego Upgrade Wizarda – zadania, które nie zostaną zmigrowane automatycznie, trzeba odtworzyć ręcznie. 

Jak przeprowadzić audyt? Użyj Extension Scanner w Admin Tools (Install Tool) backendu TYPO3 – przeskanuje on kod rozszerzeń i wskaże użycie deprecated metod, klas i stałych. Narzędzie ns_ext_compatibility na Packagist pozwala masowo sprawdzić kompatybilność zainstalowanych pakietów z docelową wersją TYPO3. Dla każdego rozszerzenia oceń trzy scenariusze: (1) rozszerzenie ma już wersję kompatybilną z v14 – aktualizuj przez Composer, (2) rozszerzenie nie ma jeszcze wsparcia v14, ale jest aktywnie rozwijane – poczekaj do feature freeze v14.2 lub skontaktuj się z autorem, (3) rozszerzenie jest porzucone lub nieaktualizowane od lat – znajdź zamiennik lub zbuduj rozwiązanie dedykowane. Szczególnie ważna zmiana: wtyczki CType=list zostały usunięte w v14 – każda wtyczka musi mieć własny dedykowany CType. Jeśli Twoje rozszerzenia używają addPlugin() ze starym formatem, konieczna jest migracja. Dokumentuj każde rozszerzenie, które nie może zostać zaktualizowane, i przedstaw interesariuszom alternatywy przed rozpoczęciem upgrade’u. 

Checklist testów przed go-live powinien obejmować następujące elementy. Test frontendu: czy wszystkie szablony Fluid renderują się poprawnie, czy responsywność działa na urządzeniach mobilnych, czy CSS i JavaScript nie generują błędów w konsoli. Test backendu: czy redaktorzy mogą tworzyć i edytować treści, czy workflow zatwierdzania działa, czy nowe nazwy modułów są zrozumiałe dla zespołu. Test wydajności: uruchom Google PageSpeed Insights i Lighthouse na stagingu – porównaj wyniki z obecną wersją. Test bezpieczeństwa: sprawdź logi systemowe, zweryfikuj uprawnienia użytkowników, przetestuj formularz kontaktowy i system logowania. Test SEO: zweryfikuj, czy metatagi, sitemap.xml, robots.txt i adresy kanoniczne działają poprawnie po upgrade’dzie. Dopiero po przejściu wszystkich testów i uzyskaniu akceptacji interesariuszy możesz przeprowadzić go-live z pełnym przekonaniem, że aktualizacja TYPO3 zakończy się sukcesem.