TYPO3 v14 API-Änderungen: Was Entwickler wissen müssen

Das bedeutet, dass die eigentliche Upgrade-Arbeit häufig im individuellen Code beginnt und nicht nur im TYPO3 Backend.

Mit TYPO3 v14 wurden veraltete Funktionen entfernt und mehrere interne Systeme modernisiert, um eine sauberere und zukunftssichere Entwicklung zu unterstützen. Individuelle Extensions, überschriebene Templates, Backend-Integrationen und die Nutzung veralteter APIs sollten vor jedem Produktiv-Upgrade überprüft werden.

In diesem Leitfaden erläutern wir die wichtigsten TYPO3 v14 API-Änderungen, die Entwickler kennen sollten, und erklären, wie Sie Ihre Codebasis auf eine reibungslosere Migration vorbereiten.

TYPO3 v14 API-Änderungen auf einen Blick

Die API-Änderungen in TYPO3 v14 betreffen veraltete APIs, Fluid 5, die Record API, PSR-14-Events, TCA, Backend-Module, Ressourcen, Extbase, Lokalisierung und die Kompatibilität von Extensions. Hier finden Sie einen schnellen Überblick über die wichtigsten Bereiche, die Sie vor dem Upgrade überprüfen sollten.

Warum TYPO3 v14 für Entwickler wichtig ist

TYPO3 v14 ist für Entwickler wichtig, weil es sich um eine LTS-Version handelt, die langfristige Änderungen an APIs, Extensions, Backend und Kompatibilität für moderne TYPO3-Projekte einführt.

TYPO3 v14 ist eine LTS-Version, was bedeutet, dass sie Upgrade-Strategien für Agenturen, Enterprise-Websites und langfristige TYPO3-Projekte maßgeblich beeinflussen wird. Mit Fehlerbehebungen bis zum 31. Dezember 2027 und Sicherheitsupdates bis zum 30. Juni 2029 ist diese Version eine wichtige Grundlage für Teams, die stabile und wartbare Plattformen benötigen.

Entwickler sollten TYPO3 v14 nicht als einfaches Patch-Update betrachten. Die größten Risiken liegen häufig in individuellen Extensions, überschriebenen Templates, Backend-Modulen und der Nutzung veralteter APIs. Entfernte, veraltete APIs können schwerwiegendere Upgrade-Probleme verursachen als neue Funktionen, insbesondere wenn alter Code aus früheren TYPO3-Versionen übernommen wurde.

Bei Upgrades von v13 auf v14 sollte der erste Schritt eine Codeprüfung sein und nicht nur ein visueller Test. Die Kompatibilität von Extensions, Fluid-Templates, TCA-Definitionen, Events und individuellen Integrationen sollte in einer Staging-Umgebung getestet werden, bevor die Migration in die Produktivumgebung erfolgt.

Entfernte veraltete Funktionen in TYPO3 v14

TYPO3 v14 entfernt veraltete Core-Funktionen, sodass Extensions, die alte APIs, Hooks, JavaScript-Pfade oder Legacy-Konfigurationen verwenden, nach dem Upgrade möglicherweise nicht mehr funktionieren.

Was Entwickler überprüfen sollten

• Individuelle Extensions nach veralteten TYPO3 Core-APIs durchsuchen.
• Den Extension Scanner vor dem Upgrade ausführen.
• TYPO3 v13-Protokolle auf Deprecation-Warnungen prüfen.
• Entfernte Hooks durch PSR-14-Events ersetzen.
• Individuelle JavaScript-Module überprüfen.
• Alte Fluid Styled Content-Überschreibungen kontrollieren.
• Entfernte Lokalisierungsdateien prüfen.
• Backend-Module und individuelles Preview-Rendering testen.

Empfohlene Maßnahmen für Entwickler

Änderungen der Record API in TYPO3 v14

TYPO3 v14 verwendet die Record API in Backend-Bereichen wie dem Preview-Rendering im Seitenmodul und dem Verhalten des Listenmoduls. Daher muss die Array-basierte Datensatzverarbeitung möglicherweise aktualisiert werden.

Was hat sich geändert

Seitenvorschauen verwenden jetzt {record} anstelle direkter Feldvariablen. Event Listener müssen außerdem möglicherweise mit RecordInterface-Objekten statt mit Arrays arbeiten.

Auswirkungen für Entwickler

Individuelle Preview-Templates, Array-basierte Datensatzverarbeitung und Backend-Anzeigelogik sollten vor dem Upgrade getestet werden.

Beispiel: Fluid-Preview-Templates sollten die Variable {record} anstelle direkter Feldvariablen verwenden.

<!-- TYPO3 v13 and lower -->
<h2>{header}</h2>
<p>{bodytext}</p>

<!-- TYPO3 v14+ -->
<h2>{record.header}</h2>
<p>{record.bodytext}</p>

Fluid 5-Änderungen in TYPO3 v14

Fluid 5 in TYPO3 v14 bringt ein strengeres Template-Verhalten, Typisierung von ViewHelpers, Regeln für Variablennamen und Änderungen beim Rendering mit sich, die Entwickler vor der Migration testen sollten.

Was Entwickler überprüfen müssen

• Individuelle Fluid-Templates, Partials und Layouts.
• Individuelle ViewHelpers und Argumenttypen.
• Variablen, die mit Unterstrichen beginnen.
• Templates, die CDATA verwenden.
• Template-Auflösung und Fallback-Verhalten.
• Fluid-Cache-Warmup.
• Neue Fluid-Komponenten.
• Überschriebene Templates von Drittanbieter-Extensions.

Checkliste für Entwickler zu Fluid 5

• Alle individuellen Templates testen.
• ViewHelpers auf strikte Typisierung überprüfen.
• Variablennamen mit führendem Unterstrich vermeiden.
• Templates mit CDATA überprüfen.
• Frontend- und Backend-Rendering testen.
• Überschriebene Extension-Templates prüfen.
• Caches während der Tests leeren und neu aufbauen.

PSR-14-Events und Hook-Ersatz

TYPO3 v14 ersetzt weiterhin Legacy-Hooks durch PSR-14-Events und bietet Entwicklern dadurch sauberere und besser wartbare Erweiterungspunkte.

Was hat sich geändert

Entwickler sollten bestehende Hook-basierte Logik überprüfen und bei Bedarf durch unterstützte PSR-14-Events ersetzen. Bestehende Event Listener sollten ebenfalls auf geänderte Payloads geprüft werden, insbesondere bei individueller Formularverarbeitung, Seiten-Rendering und Backend-Workflows.

Tabelle mit Entwicklermaßnahmen

Beim Ersetzen alter Hook-basierter Logik sollten Entwickler individuelles Verhalten – sofern unterstützt – in PSR-14-Event Listener verschieben.

use TYPO3\CMS\Backend\View\Event\PageContentPreviewRenderingEvent;

final class PreviewRenderingListener
{
   public function __invoke(PageContentPreviewRenderingEvent $event): void
   {
       $record = $event->getRecord();
       $uid = $record->getUid();

       // Add custom preview logic here
   }
}

TCA- und FormEngine API-Änderungen

TYPO3 v14 aktualisiert das Verhalten von TCA und FormEngine. Daher sollten individuelle Backend-Formulare, Feldkonfigurationen, Scheduler-Aufgaben und Datensatzeinstellungen überprüft werden.

Was Entwickler prüfen sollten

• ctrl-Optionen in individueller TCA.
• Konfiguration der Suchfelder.
• FlexForm-Konfiguration.
• TCA-Standardwerte.
• Konfiguration von Scheduler-Aufgaben.
• Individuelle Backend-Formulare.
• Individuelles Feld-Rendering.
• Einschränkungen für Seitentypen.
• Datensatztyp-Bezeichnungen.

Best Practice

TYPO3 v14 verlagert mehr Konfigurationen hin zu strukturierten, typisierten und wartbaren Mustern. Entwickler sollten nach Möglichkeit auf Legacy-Globalkonfigurationen verzichten und individuellen Code an aktuelle TCA-, PSR-14-Event- und Service-Registrierungspraktiken anpassen.

Änderungen an Backend-Modulen und der Component API

TYPO3 v14 modernisiert Backend-Module, das Verhalten des DocHeaders, Breadcrumbs, Buttons und UI-Komponenten, was sich auf individuelle Backend-Integrationen auswirken kann.

Auswirkungen für Entwickler

Individuelle Backend-Module müssen möglicherweise hinsichtlich Pfaden, Namen, Buttons, Menüs und Komponenten aktualisiert werden. Der überarbeitete DocHeader und responsive Breadcrumbs können außerdem Backend-Layouts, Editor-Workflows und ältere Dokumentations-Screenshots beeinflussen.

Was getestet werden sollte

• Routing individueller Backend-Module.
• Modulberechtigungen und Zugriffe.
• Individuelle Buttons und Shortcuts.
• Backend-UI-Komponenten.
• Verhalten der Breadcrumbs.
• Darstellung der Untermodul-Übersicht.
• JavaScript-Verhalten in Backend-Modulen.

System Resource API und Asset-Verwaltung

Die System Resource API in TYPO3 v14 verbessert die Verarbeitung von Systemdateien, öffentlichen Ressourcen-URLs, CSS, JavaScript und Extension-Assets.

Warum das wichtig ist

Alte Annahmen über Asset-Pfade sind möglicherweise nicht mehr gültig. Entwickler sollten Frontend- und Backend-Assets, Paketressourcen, generierte URLs und Integrationen testen, die von CSS, JavaScript oder Datei-URI-Verarbeitung abhängen.

Prüfpunkte für Entwickler

• Asset-Pfade von Extensions.
• Generierung öffentlicher URIs.
• Backend-JavaScript-Importe.
• CSS- und JavaScript-Einbindungen.
• SRI-Verarbeitung.
• TypoScript-Asset-Konfiguration.
• Fluid-Asset-Referenzen.

Extbase-Änderungen, die Entwickler kennen sollten

Die Extbase-Änderungen in TYPO3 v14 betreffen Controller, Actions, Validatoren, Property Mapping, Autorisierung, strikte Typisierung und Legacy-Code auf Basis von Annotationen.

Wichtige Bereiche zur Überprüfung

• Controller.
• Actions.
• Validatoren.
• Property Mapping.
• Autorisierung.
• Rate Limiting.
• Backend-Extbase-Module.
• TypoScript-Nutzung im Kontext von Backend-Modulen.
• Entfernte Annotation-Unterstützung.

Maßnahmen für Entwickler

Extbase-Extensions sollten sowohl im Frontend als auch im Backend getestet werden. Strengere Typisierung, Änderungen bei der Validierung und die entfernte Annotation-Unterstützung können technische Altlasten aufdecken, die bei einer rein visuellen Prüfung nicht sichtbar werden.

Änderungen an der Lokalisierungs- und Übersetzungs-API

TYPO3 v14 aktualisiert die Lokalisierung durch Unterstützung der Symfony Translation Component sowie die Kompatibilität mit XLIFF 1.2 und 2.x für Übersetzungen von Extensions und Backend.

Was überprüft werden sollte

• Individuelle XLIFF-Dateien.
• Übersetzungs-Labels.
• Individuelle Übersetzungs-Loader.
• Labels von Backend-Modulen.
• Sprachdateien von Extensions.
• JavaScript-Sprachlabels.
• Mehrsprachiges Preview-Verhalten.

Warum das wichtig ist

Mehrsprachige TYPO3-Projekte sind häufig auf individuelle Labels und Übersetzungen von Extensions angewiesen. Fehlerhafte Labels verhindern das Upgrade zwar meist nicht, können jedoch Redakteure verwirren, die Benutzerfreundlichkeit des Backends beeinträchtigen und Probleme in mehrsprachigen Workflows verursachen.

Änderungen an JavaScript und der Backend-UI

TYPO3 v14 entfernt ältere JavaScript-Migrationspfade und aktualisiert das Verhalten der Backend-Benutzeroberfläche. Daher sollten individuelle Backend-Skripte und modulspezifisches JavaScript überprüft werden.

Prüfpunkte für Entwickler

• Individuelle Backend-JavaScript-Module.
• Alte Importpfade.
• Verhalten von Modalfenstern und Dialogen.
• Nutzung von Backend-Komponenten.
• Integrationen des Seitenbaums.
• Modulspezifische Skripte.
• Verbleibende Annahmen aus der RequireJS-Ära.

Änderungen bei Composer, Extension-Metadaten und Classic Mode

TYPO3 v14 macht Composer-Metadaten wichtiger für die Identität von Extensions, Kompatibilität, Classic-Mode-Konfiguration und die langfristige Wartung von Paketen.

Was Entwickler aktualisieren sollten

• Composer-Einschränkungen.
• Extension-Metadaten.
• Titel der Extension.
• Kompatibilitätserklärungen.
• Einrichtung von Classic-Mode-Extensions.
• CI/CD-Installationsskripte.
• Vorbereitung der TER-Veröffentlichung.

Die Metadaten von Extensions sollten korrekt gepflegt werden, damit TYPO3 v14 Kompatibilität und Paketidentität zuverlässig erkennen kann.

{
 "require": {
   "typo3/cms-core": "^14.3"
 },
 "extra": {
   "typo3/cms": {
     "extension-key": "my_extension"
   }
 }
}

Praktischer Tipp

Auch TYPO3-Projekte ohne Composer sollten Composer-Metadaten ernst nehmen. TYPO3 v14 verlagert immer mehr Logik zur Identität und Kompatibilität von Extensions auf moderne Paketkonventionen. Veraltete Metadaten können daher Upgrade- oder Deployment-Probleme verursachen.

TYPO3 v14 Upgrade-Checkliste für Entwickler

Ein TYPO3 v14-Upgrade sollte mit einem Extension-Scan, der Bereinigung veralteter APIs, Staging-Tests, Composer-Prüfungen, Backups sowie einer vollständigen Validierung von Backend und Frontend beginnen.

Vor dem Upgrade

• Aktuelle TYPO3 Version bestätigen.
• Zuerst auf die neueste Patch-Version aktualisieren.
• PHP- und Datenbankkompatibilität prüfen.
• Alle Drittanbieter-Extensions aktualisieren.
• Den Extension Scanner ausführen.
• Deprecation-Logs überprüfen.
• Composer-Einschränkungen prüfen.
• Eine Staging-Umgebung vorbereiten.
• Datenbank und Dateien sichern.
• Alle individuellen Extensions dokumentieren.

Während des Upgrades

• TYPO3 Core in der Staging-Umgebung aktualisieren.
• Datenbankvergleich ausführen.
• Alle Caches leeren.
• Upgrade-Assistenten ausführen.
• Backend-Login prüfen.
• Individuelle Backend-Module testen.
• Seiten-Rendering testen.
• Formulare testen.
• Sprachverarbeitung testen.
• Dateiverarbeitung testen.
• System- und PHP-Logs überprüfen.

Nach dem Upgrade

• Funktionstests ausführen.
• Individuelle Fluid-Templates testen.
• Backend-Module der Extensions testen.
• Frontend-Ausgabe validieren.
• Weiterleitungen und interne Links prüfen.
• Editor-Workflows überprüfen.
• Geplante Aufgaben testen.
• CLI-Befehle prüfen.
• Produktions-Logs nach dem Go-live überwachen.

Sind Sie sich nicht sicher, ob Ihr TYPO3-Projekt für v14 bereit ist? Starten Sie mit einer technischen Kompatibilitätsprüfung, bevor Sie das Upgrade durchführen.

Häufige Risiken bei der TYPO3 v14 API-Migration

Zu den häufigsten Migrationsrisiken in TYPO3 v14 gehören fehlerhafte Extensions, Fluid-Fehler, Probleme mit der Record API, fehlende Labels, Probleme bei Backend-Modulen, Änderungen an Asset-Pfaden und Composer-Konflikte.

Best Practices für Extension-Entwickler in TYPO3 v14

Die Entwicklung von TYPO3 v14 Extensions sollte unterstützte Core APIs, PSR-14-Events, korrekte Composer-Metadaten, strukturierte TCA, mit Fluid 5 kompatible Templates und automatisierte Tests nutzen.

• PSR-14-Veranstaltungen gegenüber Legacy-Hooks bevorzugen.
• Nur die von TYPO3 Core unterstützten APIs verwenden.
• Direkten Zugriff auf interne Core-Klassen vermeiden.
• Composer-Metadaten aktuell halten.
• Automatisierte Tests für individuelle Extensions schreiben.
• Mit der aktuellen TYPO3 v14-Patch-Version testen.
• Keine fest codierten Backend-Modulpfade verwenden.
• Strukturierte TCA-Konfiguration verwenden.
• Fluid-Templates mit Fluid 5 kompatibel halten.
• TYPO3 v14-Kompatibilität in der README der Extension dokumentieren.

Sollten Sie jetzt auf TYPO3 v14 upgraden?

TYPO3 14 LTS ist stabil und wird für neue Projekte empfohlen, während TYPO3 13 LTS für bestehende Websites weiterhin unterstützt wird.

Für Unternehmen bietet v14 eine zukunftssichere Plattform mit Fehlerbehebungen bis Dezember 2027 und Sicherheitsupdates bis Juni 2029. Für Entwickler hängt die Entscheidung von der Kompatibilität der Extensions, der Qualität des individuellen Codes und der Upgrade-Bereitschaft ab.

Jetzt upgraden, wenn

• Sie ein neues TYPO3-Projekt starten.
• Ihre Extensions aktiv gepflegt werden.
• Ihre Codebasis bereits sauber unter TYPO3 v13 funktioniert.
• Sie wünschen langfristigen Support bis 2029.
• Sie das moderne Backend und aktuelle APIs benötigen.

Warten und vorbereiten, wenn

• Sie auf viele alte individuelle Extensions angewiesen sind.
• Sie noch veraltete APIs verwenden.
• Sie ungetestete Fluid-Überschreibungen nutzen.
• Ihr Projekt komplexe Integrationen enthält.
• Ihr Team die Kompatibilität mit v14 noch nicht geprüft hat.

Abschließendes Fazit für Entwickler

TYPO3 v14 ist eine Modernisierungs-Version für Entwickler und nicht nur ein visuelles Backend-Update. Der größte Teil der Upgrade-Arbeit wird wahrscheinlich in individuellen Extensions, Fluid-Templates, Änderungen an der Record API, der TCA-Konfiguration, der Migration auf PSR-14-Events, Backend-Modulen, der Ressourcenverwaltung und der Entfernung veralteter Funktionen liegen.

Entwickler, die ihren Code frühzeitig prüfen, in einer Staging-Umgebung testen und veraltete APIs vor dem Produktiveinsatz ersetzen, werden ein deutlich reibungsloseres Upgrade auf TYPO3 v14 durchführen können. Planen Sie ein TYPO3 Upgrade? Lassen Sie Ihre individuellen Extensions, APIs, Templates und Backend-Module überprüfen, bevor Sie in die Produktivumgebung wechseln.