TYPO3 v13 ist ein großer Schritt nach vorn. Es entfernt veraltete APIs, verschärft die Core-Architektur und führt strengere Standards ein, die sich direkt auf benutzerdefinierten Code und Extensions auswirken. Mit dieser Schritt-für-Schritt Anleitung können Sie Upgrades und Migrationen auf TYPO3 v13 meistern. Weitere TYPO3 Extensions von T3Planet erweitern Ihre Website zusätzlich.
Dieser Leitfaden konzentriert sich auf das, was bei einem TYPO3 Upgrade wirklich wichtig ist: Breaking Changes, die behoben werden müssen, wichtige Änderungen, die das Verhalten verändern können, sowie Deprecations, die vor TYPO3 v14 beachtet werden müssen. Nutzen Sie ihn als praktische Referenz, um Ihre TYPO3 v13 Migration mit weniger Überraschungen zu planen, umzusetzen und zu stabilisieren.
Kurze Antwort: Für ein Upgrade von TYPO3, dem Open-Source-Enterprise-CMS, von v12 auf v13.4 LTS sichern Sie Dateien und Datenbank, schließen alle Upgrade-Wizards von v12 ab, beheben Deprecations, wechseln auf PHP 8.2 oder neuer und prüfen jede Extension auf v13-Unterstützung. Danach folgen composer require mit ^13.4, die Upgrade-Wizards, der Database Analyzer und das Leeren aller Caches.
Das Wichtigste in Kürze
- TYPO3 v13.4 LTS erhält kostenlose Sicherheitsfixes bis 31. Dezember 2027, v14.3 LTS bis 30. Juni 2029 (get.typo3.org).
- Der kostenlose Support für v12 endete am 30. April 2026; kostenpflichtiges ELTS läuft längstens bis 30. April 2030 (TYPO3 ELTS).
- v13 und v14 benötigen PHP 8.2 bis 8.5 sowie MariaDB 10.4.3+, MySQL 8.0.17+ oder PostgreSQL 10+.
- Aktualisieren Sie immer nur eine Hauptversion und führen Sie bei jedem Schritt alle Upgrade-Wizards aus.
- Die Extensions bestimmen den Zeitplan: Prüfen Sie jede zuerst im TER oder auf Packagist.
- In v13 deprecated, in v14 entfernt:
$GLOBALS['TSFE']und Plugin-Subtypes.
Gültig für: TYPO3 v13.4 LTS und v14.3 LTS. Aktualisiert: November 2026.
Für wen dieser Leitfaden geeignet ist und für wen nicht
Dieser Leitfaden richtet sich an Teams, die ein ernsthaftes Upgrade auf TYPO3 v13 planen. Er konzentriert sich auf echte Migrationsarbeiten sowie langfristigen TYPO3 Support & Wartung und nicht auf Feature-Marketing.
Dieser Leitfaden ist für
- TYPO3-Agenturen, die mehrere Kundenprojekte und LTS-Upgrades betreuen
- Freelance TYPO3 Entwickler, die benutzerdefinierte Extensions und Site Packages im Rahmen skalierbarer TYPO3 Entwicklung-Workflows warten
- Inhouse TYPO3-Teams, die langlebige, geschäftskritische Websites betreiben
- Technische Leiter und CTOs, die Upgrade-Umfang, Risiken und Zeitpläne planen
Dieser Leitfaden ist nicht für
- Einsteiger, die neu bei TYPO3 sind
- Marketing oder reine Content-Rollen
- Projekte, die nahe am TYPO3 Core laufen und keinen eigenen Code oder Extensions enthalten
Was Sie gewinnen werden
- Klarheit darüber, welche Breaking Changes sofortiges Handeln erfordern
- Orientierung dazu, was ohne Upgrade-Risiko verschoben werden kann
- Eine praxisnahe Einschätzung zur Vorbereitung von TYPO3 v13-Projekten auf v14
Upgrade-Realität in TYPO3 v13
TYPO3 Upgrades sind nicht nur technische Aufgaben. Sie sind Planungsprozesse, die von langen Lebenszyklen, Extension-Abhängigkeiten und begrenzten Upgrade-Zeitfenstern geprägt sind.
Lange LTS-Zyklen prägen jede Entscheidung
TYPO3-Projekte laufen häufig 3–6 Jahre auf einer LTS-Version.
Das bedeutet:
- Alte Entscheidungen bleiben länger produktiv im Einsatz
- Technische Schulden wachsen unbemerkt
- Upgrade-Fehler sind kostspielig rückgängig zu machen
v13-Upgrades sollten als strukturelle Neustarts behandelt werden, nicht als schnelle Versionssprünge.
Extension-zentrierte Abhängigkeitsrealität
Die meisten TYPO3 Installationen hängen stärker von Extensions als vom Core ab.
In der Praxis:
- Core-Upgrades hängen von der Bereitschaft der Extensions ab
- Individuelle Extensions stellen das größte Risiko dar
- TER-Extensions unterscheiden sich stark in ihrer Wartungsqualität
Extensions sollten immer geprüft werden, bevor individueller Code angepasst wird.
Was zuerst behoben werden sollte (Blockierende Probleme)
Diese Punkte müssen vor oder während des Upgrades behoben werden:
- Wichtige Änderungen, die PHP-Fehler oder fatale Exceptions verursachen
- Entfernte Hooks, die durch PSR-14-Events ersetzt wurden
- Inkompatibilitäten mit QueryBuilder, Doctrine und Symfony
- Veraltete APIs, deren Entfernung in v14 geplant ist
Diese Punkte führen zu einem Ausfall der Website, nicht nur zu Warnmeldungen im Log.
Was warten kann (Aufräumen nach dem Upgrade)
Diese Aufgaben können nach der Stabilisierung eingeplant werden:
- Veraltete, aber noch funktionsfähige APIs
- Internes Refactoring für eine sauberere Architektur
- Performance-Optimierungen ohne direkten Bezug zu v13-Änderungen
Das Verschieben dieser Aufgaben ist akzeptabel, sollte jedoch dokumentiert und nachverfolgt werden.
Diese Denkweise sorgt dafür, dass TYPO3 v13 Upgrades planbar und kontrolliert bleiben und sich an langfristiger Wartung orientieren – nicht nur an der Einhaltung einer Versionsanforderung.
Praktische Upgrade-Anleitung für TYPO3 v13 Projekte
Dieser Abschnitt konzentriert sich auf Aktion, die in realen TYPO3-Projekten tatsächlich Upgrade-Zeit und Risiko reduzieren. Er spiegelt Muster wider, die sich in Agenturprojekten, langlaufenden Websites und bei der Wartung von Extensions zeigen.
Empfohlener Upgrade-Pfad
- Zuerst auf die neueste TYPO3 v12 LTS-Version aktualisieren.
- Alle Deprecations und Extension-Warnungen in v12 beheben.
- Erst danach auf v13 wechseln und die Core-Upgrade-Wizards verwenden.
- Das Überspringen von Major-Versionen bei aktiven Projekten sollte vermieden werden.
Dieser zweistufige Weg fängt die meisten Breaking Changes frühzeitig ab und hält ein Rollback einfach.
Pre-Upgrade-Checks (Zuerst durchführen)
- Prüfen, ob alle Extensions v13-kompatibel sind oder aktiv gewartet werden
- Nicht verwendete oder aufgegebene TER-Extensions entfernen
- TYPO3 Deprecation-Logs ausführen und Warnungen in v12 beheben
- Individuellen Code prüfen auf:
- Hook-Nutzung (stdWrap, TSFE, IconFactory)
- Nutzung von QueryBuilder und Doctrine
Backend-JavaScript-Modulimporte
Das Überspringen dieser Prüfungen ist die häufigste Ursache für fehlgeschlagene Upgrades.
Upgrade-Sequenz, die tatsächlich funktioniert
- PHP und Systemanforderungen aktualisieren
- TYPO3-Core über Composer aktualisieren
- Alle Installations-Tool-Assistenten ausführen
- Caches leeren und Backend-Zugriff erneut prüfen
- Fatale Fehler beheben, bevor das Frontend angepasst wird
Frontend-Probleme sollten erst analysiert werden, wenn das Backend stabil läuft.
Validierung nach dem Upgrade
- Backend-Formulare, RTE und individuelle Module testen
- Login, Berechtigungen und Workspaces überprüfen
- CLI-Befehle und Scheduler-Tasks prüfen
- Logs auf verbleibende Deprecations oder Notices kontrollieren
Die meisten versteckten Probleme treten in Backend-Workflows auf, nicht auf Seiten im Frontend.
Häufige Fehler von TYPO3-Teams
- Deprecations als optionales Aufräumen behandeln
- Legacy-Hooks beibehalten, statt auf PSR-14 umzusteigen
- Laufzeit-Fixes mit Composer-Updates vermischen
- Strict-Typing-Probleme erst in der Produktion sichtbar werden lassen
Diese Punkte erhöhen die langfristigen Wartungskosten, nicht nur den Upgrade-Aufwand.
Perspektive von Extension-Autoren (Was jetzt wichtig ist)
TYPO3 v13 setzt eine klarere Architektur durch:
- PSR-14-Veranstaltungen ersetzen die meisten Legacy-Hooks
- Strenge Typisierung ist in Extbase nicht mehr optional
- Composer-Disziplin ist entscheidend für stabile Abhängigkeiten
Extensions, die diese Regeln einhalten, lassen sich sauber upgraden. Andere werden schnell zu technischer Schuld.
Wie führen Sie das Upgrade auf TYPO3 v13 mit Composer durch?
Arbeiten Sie auf einer Kopie, nie auf dem Produktivsystem: zuerst PHP, dann Extensions, dann der Core, dann die Upgrade-Wizards. Die Reihenfolge folgt der offiziellen TYPO3 Anleitung für Major-Upgrades mit Composer.
Checkliste vor dem Upgrade
- Backup von Dateien und Datenbank, mit getesteter Wiederherstellung (siehe den Leitfaden zur TYPO3 Notfallwiederherstellung).
- Alle Upgrade-Wizards von v12 erledigt (
upgrade:listzeigt keine). - Deprecation-Log und Extension Scanner ausgewertet.
- Referenzindex aktualisiert (
referenceindex:update). - Jede Extension auf ein v13-Release geprüft, zum Beispiel mit dem TYPO3 Upgrade-Kompatibilitätsbericht.
- Hosting bietet PHP 8.2+ und Composer 2.1+.
Upgrade-Schritte
- Zuerst PHP aktualisieren. Wechseln Sie auf die höchste PHP-Version, die v12 unterstützt (maximal 8.4), testen Sie, dann ändern Sie TYPO3. So trennen Sie PHP-Fehler von Core-Fehlern.
- Extensions innerhalb von v12 aktualisieren. Installieren Sie das neueste Release, das noch v12 unterstützt.
- Blocker finden.
composer why-not typo3/cms-core ^13.4listet die Pakete, die das Upgrade verhindern. - Code-Anpassungen automatisieren. TYPO3 Rector schreibt PHP-Code um (Regeln für TYPO3 10 bis 14), Fractor migriert TypoScript-, FlexForm-, YAML- und Fluid-Dateien. Prüfen Sie jede Änderung in Git, siehe unseren TYPO3 Rector Leitfaden.
- Neuen Core anfordern. Erstellen Sie den vollständigen Befehl mit dem Composer Helper.
- Aufgaben nach dem Upgrade ausführen. Caches leeren, fehlende Tabellen im Database Analyzer anlegen, alle Upgrade-Wizards ausführen, Caches erneut leeren, Sprachpakete aktualisieren (offizielle Liste).
- Ergebnis prüfen. Lesen Sie den Statusbericht (Modul Berichte) und die Logs, testen Sie Backend-Formulare und Scheduler-Tasks.
composer require --dev ssch/typo3-rector a9f/typo3-fractor
vendor/bin/typo3-init
vendor/bin/rector process --dry-run
vendor/bin/fractor process --dry-run
composer why-not typo3/cms-core ^13.4
composer require --update-with-all-dependencies "typo3/cms-core:^13.4" "typo3/cms-backend:^13.4"
vendor/bin/typo3 upgrade:list
vendor/bin/typo3 upgrade:run
vendor/bin/typo3 cache:flush
vendor/bin/typo3 language:update TYPO3 v13 vs TYPO3 v14 - Übersicht zur Upgrade-Bereitschaft
Diese Tabelle hilft Teams zu verstehen, welche Änderungen jetzt verpflichtend sind und welche künftig zu Blockern werden. Sie eignet sich ideal für KI-Snippets und Featured Answers.
| Bereich | TYPO3 v13 Status | TYPO3 v14 Auswirkung | Was Teams tun sollten |
| Legacy Hooks | Entfernt | Nicht verfügbar | Vollständig auf PSR-14-Events migrieren |
| QueryBuilder APIs | Geändert | Stabil | Jetzt aktualisieren; v14 unterstützt keine Legacy-Aufrufe mehr |
| Extbase Typing | Erzwungen | Strenger | Type Hints und Methodensignaturen korrigieren |
| $GLOBALS['TSFE'] | Veraltet | Entfernt | Context API oder Request-Attribute verwenden |
| Fluid renderStatic() | Veraltet | Entfernt | ViewHelpers refaktorisieren |
| Plugin via list_type | Veraltet | Entfernt | Eigenen CType pro Plugin verwenden |
| CKEditor-Konfigurations-Fallbacks | Entfernt | Stabil | Explizite YAML-Arrays verwenden |
| Backend-JS-Legacy-Module | Veraltet | Entfernt | Auf moderne ES-Module umstellen |
| PageTS via API | Veraltet | Entfernt | In Konfigurationsdateien auslagern |
| Datetime-INT-Felder | Geändert | Stabil | Verwendung von BIGINT sicherstellen |
Kernaussage:
Ein TYPO3 v13-Upgrade, das Deprecations ignoriert, ist nur zur Hälfte abgeschlossen. Wer sie jetzt behebt, reduziert den Aufwand für v14 deutlich.
TYPO3 v13 LTS oder v14: Auf welche Version sollten Sie aktualisieren?
Für die meisten v12-Websites ist im November 2026 TYPO3 v14.3 LTS das bessere Ziel, erreicht über v13.4 im selben Projekt, denn v14 erhält 18 Monate länger kostenlose Sicherheitsfixes. Bleiben Sie vorerst bei v13.4, wenn Extensions, auf die Sie angewiesen sind, noch nicht für v14 verfügbar sind.
| Version | Veröffentlicht | Kostenlose Sicherheitsfixes bis | PHP | Status im November 2026 |
| TYPO3 v12.4 | 25. April 2023 | 30. April 2026 | 8.1 bis 8.4 | Nur ELTS (kostenpflichtig) |
| TYPO3 v13.4 LTS | 15. Oktober 2024 | 31. Dezember 2027 | 8.2 bis 8.5 | Unterstützt, für bestehende Projekte |
| TYPO3 v14.3 LTS | 21. April 2026 | 30. Juni 2029 | 8.2 bis 8.5 | Aktuelle LTS, für neue Projekte |
Quellen: TYPO3 12, TYPO3 13 und TYPO3 14 auf get.typo3.org.
Entscheidungshilfe
| Ihre Ausgangslage | Upgrade-Ziel | Geeignet für | Einschränkung |
| Auf v12, alle wichtigen Extensions unterstützen v14 | v14.3 LTS über v13.4 | Längster kostenloser Support | Zwei Runden Upgrade-Wizards und die Breaking Changes von v14 |
| Auf v12, wichtige Extensions unterstützen nur v13 | Jetzt v13.4 LTS | Schnell wieder kostenlose Sicherheitsfixes | Den Schritt auf v14 vor Ende 2027 einplanen |
| Bereits auf v13.4 | v14.3, sobald Ihre Extensions bereit sind | Keine Frist vor 2028 | Zuerst die v13-Deprecations beheben, in v14 sind sie entfernt |
| Auf v11 oder älter | v12, v13, dann v14, Schritt für Schritt | Websites ohne kostenlose Sicherheitsfixes | Template- und Extension-Arbeit einplanen |
Am häufigsten blockieren beim zweiten Schritt der entfernte TypoScriptFrontendController (Breaking #107831), die entfernten Plugin-Subtypes (Important #105538) und Fluid 5.0.
Wenn Sie die Arbeit lieber abgeben: Der TYPO3 Upgrade-Service von NITSAN plant und führt den Schritt von v12 auf v13.4 oder v14.3 für Sie durch.
TYPO3 v13 Upgrade-Änderungen, risikobasierte Übersicht
TYPO3 v13 bringt erhebliche interne Änderungen mit sich. Nicht alle erfordern die gleiche Dringlichkeit. Um eine realistische Upgrade-Planung zu unterstützen, sind die folgenden Änderungen nach tatsächlichem Projektrisiko gruppiert, nicht nach Changelog-Kategorie.
Dies hilft Teams zu entscheiden:
- Was vor dem Upgrade behoben werden muss
- Was nach dem Upgrade getestet werden sollte
- Was später als Aufräumarbeit für v14 erledigt werden kann
Änderungen mit hohem Risiko (Müssen vor oder während des Upgrades behoben werden)
Diese Änderungen führen zu Funktionsausfällen oder fatalen Fehlern, wenn sie nicht berücksichtigt werden.
QueryBuilder- und Database-API-Änderungen
ExpressionBuilder-Änderungen
Die Methodensignaturen wurden geändert:
ExpressionBuilder::literal()erfordert nun zwingend einen StringExpressionBuilder::trim()benötigt jetzt dasTrimMode-Enum
Vor v13
add()
getQueryPart(), getQueryParts()
resetQueryPart(), resetQueryParts()
execute()
setMaxResults(0) Erforderliche Änderungen
- Verwenden Sie
executeQuery()für SELECT. - Verwenden Sie
executeStatement()für INSERT / UPDATE / DELETE. - Verwenden Sie
nullanstelle von0für unbegrenzte Ergebnisse.
Vor v13
Authentifizierung und Kontextzugriff
LoginType in native Enumeration umgewandelt
\TYPO3\CMS\Core\Authentication\LoginType ist jetzt eine PHP-Enumeration.
Alte Konstanten wurden entfernt.
Vor v13
$TSFE->fe_user entfernt
Der direkte Zugriff auf Frontend-Benutzerdaten über $TSFE ist nicht mehr möglich.
Vor v13
// After v13
This method is gone.
Use getFirstPageNumber(), getLastPageNumber(), or create your own iteration logic. $frontendUser = $this->request->getAttribute('frontend.user');
$username = $frontendUser->user['username'] ?? ''; Entfernte Hooks (PSR-14 erforderlich)
Die folgenden Hooks wurden vollständig entfernt und führen zu Fehlern, wenn sie weiterhin referenziert werden:
stdWrapHookgetDataHookpostInitHook- Icon Overlay Override Hook
Erforderliche Aktion
- Entfernen Sie die Hook-Registrierungen
- Ersetzen Sie diese durch die entsprechenden PSR-14-Events
Änderung des Backend-Layout-Providers
PageTsBackendLayoutDataProvider als endgültig markiert
\TYPO3\CMS\Backend\View\BackendLayout\PageTsBackendLayoutDataProvider kann nicht mehr erweitert werden.
Vor v13
class MyProvider extends PageTsBackendLayoutDataProvider {
} class MyProvider implements BackendLayoutDataProviderInterface {
} Änderungen mit mittlerem Risiko (Verhaltensänderungen nach dem Upgrade)
Diese Änderungen führen möglicherweise nicht zum Absturz des Systems, verändern jedoch das Verhalten, die Ausgabe oder die Editor-Erfahrung.
Änderung der CKEditor-Konfiguration
removePlugins Fallback entfernt
Die stringbasierte Konfiguration wird nicht mehr unterstützt.
Vor v13
editor:
config:
removePlugins:
- image Änderungen bei der Indexed Search
Indexed Search als Content-Element deklariert
EXT:indexed_search ist jetzt ein CType statt eines Plugins.
Maßnahme
- Führen Sie den Upgrade-Wizard aus:
„Migrate Indexed Search plugins to content elements“
Änderungen bei der Pagination
getAllPageNumbers() entfernt
Diese Methode existiert nicht mehr.
Maßnahme
- Verwenden Sie
getFirstPageNumber() - Verwenden Sie
getLastPageNumber() - Oder implementieren Sie benutzerdefinierte Iterationslogik
Änderungen im Verhalten der Utility-Funktionen
Kontinuierliche Array-Schlüssel in intExplode()
Wenn removeEmptyEntries = true, sind die Schlüssel jetzt fortlaufend.
Vorher
[0 => 1, 2 => 3] Editor und Assistentenverhalten
Neuer Inhaltselement-Assistent, abgeleitet von TCA
show := removeFromList() funktioniert nicht mehr.
Erforderliche Änderung
removeItems := addToList(html) SEO & Link-Validierung
Validierung externer Links standardmäßig deaktiviert
EXT:linkvalidator überprüft externe Links nur noch, wenn diese Funktion aktiviert ist.
Aktion
mod.linkvalidator.linktypes = db,file,external Standardmäßige Twitter Card geändert
Der Standardwert wurde von summary auf summary_large_image geändert.
Änderungen mit geringem Risiko (Aufräumarbeiten und v14-Vorbereitung)
Diese Änderungen blockieren TYPO3 v13 nicht, sollten jedoch behoben werden, um den zukünftigen Upgrade-Aufwand zu reduzieren.
Datenbank & Schema
BIGINT für Datetime-Felder
Datetime TCA-Felder verwenden jetzt BIGINT, um das Jahr-2038-Problem zu vermeiden.
Vorher
Abhängigkeits-Updates
- Symfony auf Version 7 aktualisiert
- Doctrine DBAL auf Version 4 aktualisiert
Diese Änderungen sind größtenteils durch die oben genannten QueryBuilder-Fixes abgedeckt.
Entfernte Legacy-Strukturen
- Unbenutzte
tt_content-Felder entfernt cache_treelist-Tabelle entfernt
Dies betrifft nur Projekte, die noch auf diese Strukturen zugreifen.
Anpassung der Indexed Search
Die Manipulation von endgültigen Suchabfragen in EXT:indexed_search hat sich geändert. Dies ist nur relevant, wenn benutzerdefinierte Logik existiert.
Anwendung in der Praxis
- Beheben Sie Änderungen mit hohem Risiko vor dem Upgrade
- Testen Sie Änderungen mit mittlerem Risiko während der QA
- Planen Sie Änderungen mit geringem Risiko als Aufräumarbeiten
Dies vermeidet unnötige Arbeiten und hält TYPO3 Upgrades planbar und kontrolliert.
Kostenloser TYPO3 Upgrade-Leitfaden
Ein 18-seitiges PDF und eine Excel-Arbeitsmappe, die alle Extensions auf einem Blatt erfassen und das Upgrade auf v14 in vier Phasen planen.
Deprecations (Vorbereitung auf TYPO3 v14)
Die folgenden APIs und Muster sind in TYPO3 v13 noch verfügbar, werden jedoch in TYPO3 v14 entfernt. Sie blockieren ein sofortiges Upgrade, aber das unbehandelte Verlassen dieser Änderungen wird den zukünftigen Upgrade-Aufwand erhöhen.
Empfehlung:
Beheben Sie diese während der v13-Upgrade-Arbeiten, wo immer möglich, insbesondere in Extensions, die Sie aktiv warten.
1. ExtensionManagementUtility::addPageTSConfig()
Diese Methode ist veraltet und wird in v14 entfernt.
Was zu tun ist:
Verschieben Sie die Page TS-Konfiguration in eine dedizierte Konfiguration/page.tsconfig-Datei.
2. DuplicationBehavior-Klasse
Die Legacy-Klasse ist veraltet.
Vorher:
$behavior = \TYPO3\CMS\Core\Resource\DuplicationBehavior::RENAME; $behavior = \TYPO3\CMS\Core\Resource\Enum\DuplicationBehavior::RENAME; 3. AbstractFile::FILETYPE_* Konstanten
Alle AbstractFile::FILETYPE_* Konstanten sind veraltet.
Vorher:
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_UNKNOWN
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_TEXT
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_IMAGE
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_AUDIO
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_VIDEO
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_APPLICATION \TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_UNKNOWN -> \TYPO3\CMS\Core\Resource\FileType::UNKNOWN->value
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_TEXT -> \TYPO3\CMS\Core\Resource\FileType::TEXT->value
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_IMAGE -> \TYPO3\CMS\Core\Resource\FileType::IMAGE->value
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_AUDIO -> \TYPO3\CMS\Core\Resource\FileType::AUDIO->value
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_VIDEO -> \TYPO3\CMS\Core\Resource\FileType::VIDEO->value
\TYPO3\CMS\Core\Resource\AbstractFile::FILETYPE_APPLICATION -> \TYPO3\CMS\Core\Resource\FileType::APPLICATION->value Ändern Sie dasselbe für TEXT, AUDIO, VIDEO, APPLICATION und UNKNOWN.
4. DataProviderContext Getter und Setter
Seit TYPO3 v13.4 verwendet Datenanbieterkontext die Konstruktor-Property-Promotion und wird in v14 zu einer readonly, finalen Klasse.
Vorher (setter-basiert):
$dataProviderContext = GeneralUtility::makeInstance(DataProviderContext::class);
$dataProviderContext
->setPageId($pageId)
->setData($parameters['row'])
->setTableName($parameters['table'])
->setFieldName($parameters['field'])
->setPageTsConfig($pageTsConfig); $dataProviderContext = new DataProviderContext(
pageId: $pageId,
tableName: $table,
fieldName: $field,
data: $row,
pageTsConfig: $pageTsConfig
); $pageId = $dataProviderContext->getPageId() $pageId = $dataProviderContext->pageId 5. TypoScriptFrontendController und $GLOBALS['TSFE']
TypoScriptFrontendController und $GLOBALS['TSFE'] sind veraltet und werden in v14 entfernt.
Was zu tun ist:
Verwenden Sie Request-Attribute oder die Context API.
Vor v13:
6. Fluid-Eigenständige Methoden
Mehrere eigenständige Fluid-Methoden wie TYPO3Fluid\Fluid\Core\ViewHelper\AbstractTagBasedViewHelper->registerUniversalTagAttributes() und AbstractTagBasedViewHelper->registerTagAttribute() sind veraltet.
Auswirkung:
Benutzerdefinierte ViewHelpers können Warnmeldungen auslösen.
Maßnahme:
Überprüfen Sie Fluid-Extensions und folgen Sie der aktuellen Fluid-API-Dokumentation.
7. Table-abhängige columnsOnly-Definition
Der columnsOnly-Parameter muss jetzt pro Tabelle definiert werden.
Vorher:
8. Namespace-Kurzform-Validatoren in Extbase
Die Notation für Namespaced Shorthand Validators ist veraltet.
Vorher:
#[Extbase\Validate(['validator' => \TYPO3\CMS\Extbase\Validation\Validator\NotEmptyValidator::class])]
protected $myProperty1;
#[Extbase\Validate(['validator' => \Vendor\Extension\Validation\Validator\CustomValidator::class])]
protected $myProperty2; Benutzerdefinierte Validatoren müssen vollständige Klassennamen verwenden.
9. Benutzerdefinierte Fluid-Views in Extbase
StandaloneView, TemplateView und verwandte Klassen sind veraltet.
Ersatz:
Verwenden Sie ViewFactoryInterface.
Dies betrifft benutzerdefinierte Extbase-Rendering-Logik.
10. renderStatic() in Fluid ViewHelpers
renderStatic() und verwandte Traits sind veraltet.
Vorher:
ViewHelpers entsprechend umgestalten.
11. IconRegistry-Instanziierung in ext_localconf.php
Die manuelle Icon-Registrierung in ext_localconf.php ist veraltet.
Vor v13:
13. Plugin-Content-Elemente und SubTypes
Die Registrierung von Plugins über list_type ist veraltet.
TYPO3 v14-Ansatz:
Jedes Plugin muss seinen eigenen CType haben.
14. @typo3/backend/wizard.js
Das Legacy-Wizard-Modul ist veraltet.
Ersatz:
@typo3/backend/multi-step-wizard.js @typo3/backend/page-tree/page-tree-element @typo3/backend/tree/page-tree-element Aktualisieren Sie benutzerdefinierte Backend-Module entsprechend.
16. GeneralUtility::hmac()
GeneralUtility::hmac() ist veraltet.
Ersatz:
$hmac = GeneralUtility::hmac('some-input', 'some-secret'); Umgang mit Deprecations in der Praxis
- Blockiere dein v13-Upgrade nicht nur wegen Deprecations.
- Behebe Deprecations in aktiv gewarteten Extensions.
- Entferne veraltete APIs in eigenem Code, den du kontrollierst.
- Lasse Drittanbieter-Extensions für Vendor-Updates, falls notwendig.
Das frühzeitige Angehen dieser Punkte reduziert den Aufwand erheblich, wenn du auf TYPO3 v14 umsteigst.
Praktische Upgrade-Checkliste für Ihr Projekt
Verwende diese Liste als letzte Überprüfung vor und nach deinem v13-Upgrade.
Vor dem Upgrade
- Überprüfe und behebe Wichtige Änderungen im eigenen Code
- Ersetze entfernte Hooks durch PSR-14-Events
- Prüfe Extensions auf v13-Kompatibilität
- Behebe alle in v12 gemeldeten Deprecations
Während des Upgrades
- Führe alle Upgrade-Wizards im Install-Tool aus
- Validere Datenbankschema- und TCA-Änderungen
- Leere Caches und bestätige Backend-Zugriff
Nach dem Upgrade
- Teste Backend-Workflows, RTE und benutzerdefinierte Module
- Überprüfe das Frontend-Rendering und kritische Benutzerflüsse
- Durchsuche den Code nach veralteten APIs und Konstanten
- Überwache Logs auf verbleibende Warnungen oder Notices
Projekte, die diese Schritte als obligatorisch und nicht optional behandeln, vermeiden die meisten Upgrade-Regressionsfehler und reduzieren langfristige Wartungsrisiken.
Fazit
TYPO3 v13 zieht die Plattform an den richtigen Stellen an. Legacy-Hooks sind verschwunden, APIs sind klarer, und Abhängigkeiten sind modernisiert. Das Upgrade ist handhabbar, wenn es methodisch angegangen wird.
Projekte, die Breaking Changes frühzeitig beheben und Deprecations jetzt aufräumen, werden mit deutlich weniger Aufwand in TYPO3 v14 übergehen. Nach der Stabilisierung des aktualisierten Systems können Teams die AI Foundation für TYPO3 nutzen, um KI-Anbieter, Tools, Berechtigungen und Workflows über eine gemeinsame Grundlage hinzuzufügen.
Den nächsten Schritt zu TYPO3 v14 planen
Der kostenlose Upgrade-Leitfaden behandelt Bestandsaufnahme, Upgrade-Reihenfolge, Go-live und die Sicherheitsroutine danach, für Websites auf v11, v12 oder v13.
FAQs
Ja. TYPO3 v14 entfernt APIs und Muster, die in v13 nur veraltet sind. Das Überspringen von v13 bedeutet, dass man gleichzeitig mit Breaking Changes und Deprecations umgehen muss, was das Upgrade-Risiko erheblich erhöht. Ein sauberes v13-Upgrade reduziert den Aufwand und macht den Übergang zu v14 planbar.
Benutzerdefinierte Extensions sind der häufigste Fehlerpunkt. Entfernte Hooks, Änderungen an der QueryBuilder-API, striktere Typisierung in Extbase und der veraltete Zugriff auf $GLOBALS['TSFE'] führen oft zu fatalen Fehlern. Core-only-Projekte mit minimaler Anpassung können normalerweise mit weniger Problemen upgraden.
Ja, aber es wird nicht empfohlen. Deprecations blockieren TYPO3 v13 nicht, aber sie ungelöst zu lassen, erhöht die technische Schuld und macht das Upgrade auf v14 schwieriger. Deprecations in aktiv gewarteten Extensions sollten während des v13-Upgrade-Zyklus behoben werden.
Extensions sollten zuerst geprüft werden. TYPO3-Upgrades scheitern oft an inkompatiblen Extensions, nicht an Core-Änderungen. Beheben oder ersetzen Sie nicht unterstützte Extensions, bevor Sie eigenen Code refaktorisieren. Eigene Extensions erfordern oft mehr Arbeit als Site-Pakete oder Templates.
Es hängt von der Projektkomplexität ab. Einfache Projekte können in wenigen Tagen aktualisiert werden. Projekte mit mehreren benutzerdefinierten Extensions und Legacy-Hooks benötigen oft mehrere Wochen, einschließlich Tests und Aufräumarbeiten. Planung und Extensions-Audits haben mehr Einfluss als reine Entwicklungszeit.
Deprecations als optional zu behandeln und architektonische Fixes aufzuschieben. Legacy-Hooks, lockere Typisierung und veraltete APIs funktionieren vielleicht noch in v13, werden aber in v14 fehlschlagen. Sie frühzeitig zu beheben, reduziert die langfristigen Wartungskosten und vermeidet hektische Upgrades später.
Wolfgang Weber
Brand & Communication LeadWolfgang Weber gestaltet TYPO3 mit Leidenschaft und Fachwissen. Als TYPO3-Enthusiast beim T3Planet Shop hat er an TYPO3-Projekten mitgewirkt, die Websites schneller und sicherer machen. Abseits von TYPO3 findet man ihn wahrscheinlich beim Erkunden lokaler Cafés oder beim Fußball.
More From Author