TYPO3 13 auf 14: Was sich technisch wirklich ändert

Was sich in TYPO3 14 architektonisch ändert

TYPO3 14 ist kein Versions-Routine-Update. Wer es so behandelt, stößt auf entfernte APIs und Konfigurationsoptionen, die in Version 13 noch mit Deprecation-Warning liefen. Die Änderungen sind gut dokumentiert, planbar — und an manchen Stellen konsequenter als die 12-auf-13-Migration.

Ein erster struktureller Unterschied zur 12-auf-13-Migration: Die PHP-Mindestanforderung steigt diesmal nicht. Sowohl TYPO3 13 als auch TYPO3 14 laufen ab PHP 8.2; PHP 8.5 ist in Version 14 neu kompatibel. Für Hosting-Konfigurationen ändert sich damit meist nichts — der Server, der TYPO3 13.4 trägt, trägt in der Regel auch 14.x.

Die eigentlichen Änderungen liegen tiefer: im PHP-Code, in der Konfiguration und in der Frontend-Asset-Pipeline.

TypoScriptFrontendController ist weg

Das ist die signifikanteste API-Entfernung in TYPO3 14. Die Klasse TypoScriptFrontendController (TSFE) war über Jahrzehnte die zentrale Anlaufstelle für alles, was mit dem Frontend-Rendering zu tun hatte: Zugriffskontrollen, Caching-Logik, Seiteninformationen. Wer eigene Extensions entwickelt hat, die direkt auf $GLOBALS['TSFE'] zugreifen, oder wer Hooks registriert hat, die über diesen Controller laufen, hat einen direkten Breaking Change vor sich.

TYPO3 hat diese Entfernung nicht überstürzt. Die Ablösung war schrittweise vorbereitet und in Version 13 durch Deprecation-Warnings angekündigt. Die Praxis zeigt dennoch: Dieser Punkt wird unterschätzt, da $GLOBALS['TSFE'] in älterem Custom-Code häufig vorkommt — auch dort, wo es keinen offensichtlichen Grund gibt.

Konfiguration: Was in TYPO3 14 nicht mehr funktioniert

Mehrere TCA-Kontrolloptionen, die über Versionen hinweg mitgeführt wurden, sind in 14 hart entfernt: is_static und searchFields in TCA-Kontrollen, FlexForm-Pointer-Felder, die Backend-Layout-Registrierung über $GLOBALS. Wer noch Konfiguration aus der TYPO3-6.x- oder 7.x-Ära mitführt, trifft hier wahrscheinlich auf Fehler.

Die Frontend-Asset-Pipeline hat eine weitere Konsequenz: Automatische Konkatenation und Komprimierung von CSS- und JavaScript-Dateien ist in TYPO3 14 entfernt. Wer diese Funktion genutzt hat — in älteren Setups war das ein üblicher Weg, um Build-Tools zu umgehen — braucht jetzt einen externen Asset-Prozess.

Lokalisierung: Symfony Translation Component als neue Basis

TYPO3 14 überführt die Lokalisierungsarchitektur auf den Symfony Translation Component. Das hat praktische Folgen: XLIFF-2.x-Dateien werden jetzt unterstützt; wer mehrsprachige Extensions oder eigene Übersetzungsdateien pflegt, sollte die Kompatibilität prüfen. Der alte Lokalisierungs-Layer war intern, aber er wurde an unerwarteten Stellen genutzt — Extensions, die direkt in die Lokalisierungs-API eingriffen, sind Kandidaten für manuelle Korrekturen.

Der häufigste Migrationskiller: entfernte Deprecations

Das Muster ist dasselbe wie beim 12-auf-13-Wechsel: Was TYPO3 13 noch mit Deprecation-Warning durch ließt, ist in Version 14 entfernt. Das umfasst Hooks (afterBuildingFinished, beforeFormCreate und mehrere formularbezogene Hooks), interne Methoden in ResourceFactory und AbstractFile sowie die Extbase-Logik, die bisher automatisch Seiten-IDs aus TypoScript ermittelt hat.

Der Scheduler ist ein konkreter Fall, der eine Migration erfordert: Das Speicherformat für Scheduler-Tasks hat sich geändert. Wer Scheduler-Tasks produktiv betreibt, muss nach dem Upgrade den Upgrade-Wizard ausführen — sonst laufen bestehende Tasks nicht mehr.

Wer das Deprecation-Log seiner TYPO3-13-Instanz konsequent genutzt hat, kennt seinen Zustand bereits. Wer es ignoriert hat, lernt ihn beim 14er-Upgrade kennen. Der Unterschied ist, dass beim vorbereiteten Wechsel Zeit und Kontext vorhanden sind; beim erzwungenen nicht.

Wie eine Migration sinnvoll abläuft

Der Ablauf unterscheidet sich strukturell nicht von einem 12-auf-13-Wechsel. Was sich ändert: Der erste Prüfpunkt ist nicht der PHP-Versionsstand des Servers, sondern der eigene Code.

Deprecation-Audit in TYPO3 13. Bevor ein Upgrade auf 14 startet, das Deprecation-Log der laufenden 13er-Installation vollständig abarbeiten. TSFE-Zugriffe, veraltete Hook-Registrierungen, TCA-Konfigurationsoptionen und Legacy-Asset-Konfiguration tauchen dort auf — sofern sie genutzt werden.

Testumgebung zuerst. Der gesamte Upgrade-Prozess läuft auf einer Kopie der Produktivinstanz. Scheduler-Migrations-Wizard, Funktionstest aller Custom-Extensions und ein Frontend-Kompletttest gehören zur Pflicht-Checkliste.

Extension-Kompatibilität prüfen. Dasselbe gilt wie beim 12-auf-13-Wechsel: Jede installierte Extension gegen die 14.x-Kompatibilität abgleichen. Die Lokalisierungsänderungen und die TSFE-Entfernung sind die Stellen, an denen Extensions am häufigsten brechen werden.

Composer update auf 14.x. In einer Composer-basierten Installation die Versionsconstraints anpassen, composer update ausführen, Upgrade-Wizards in der Install-Tool-Oberfläche durchlaufen lassen.

Scheduler-Migration nicht übersehen. Nach dem Upgrade explizit den Upgrade-Wizard für Scheduler-Tasks ausführen; sonst laufen bestehende Tasks im neuen Format nicht mehr.

Was stabil bleibt: der Seitenbaum, die Redaktionsoberfläche, TypoScript — soweit es keine entfernten TSFE-Abhängigkeiten enthält —, Fluid-Templates und ContentBlocks. Ein Upgrade auf 14 ist kein Anlass für einen Redakteur-Relaunch.

Wann der Wechsel sinnvoll ist

TYPO3 13.4 als LTS hat aktiven Community-Support bis Oktober 2027. Es besteht kein sofortiger Handlungsdruck, solange die Instanz auf 13.4 läuft und das Deprecation-Log gepflegt wurde.

Der sinnvolle Migrationszeitpunkt ist wie beim 12-auf-13-Wechsel nicht der Tag-1-Release von 14.0, sondern der erste Patch-Stand nach dem LTS: In diesem Fall 14.3, das als LTS-Version im April 2026 erschienen ist, und damit Extensions-Maintainern ausreichend Zeit gegeben hat, Kompatibilität herzustellen.

Wer noch auf TYPO3 12.x läuft, sollte den direkten Sprung auf 14 vermeiden. Der technisch saubere Weg führt über 13.4: Deprecations abarbeiten, Extensions anpassen, testen, 13.4 stabilisieren — dann erst den 14er-Sprung angehen. Zwei Major-Versionen gleichzeitig zu überspringen verdoppelt nicht den Aufwand, sondern vervielfältigt die Überraschungen.

Wie aufwändig der Wechsel wird, hängt nicht an TYPO3 14, sondern am Zustand des bestehenden Codes. Wer eine saubere 13.4-Installation mit gepflegten Extensions betreibt und das Deprecation-Log kennt, hat eine planbare Migration vor sich. Wer über Jahre nichts angefasst hat, wird die akkumulierte Schuld beim 14er-Upgrade zum ersten Mal vollständig sehen.

Quellen

• TYPO3 v14 Changelog: docs.typo3.org/c/typo3/cms-core
• TYPO3 Roadmap und Release-Daten: typo3.com/typo3-cms/development-roadmap/roadmap
• TYPO3 v13 ELTS: typo3.com/services/extended-long-term-support-elts