TYPO3-Update: Versions-Überblick, Upgrade-Pfade und Stolperfallen

Ein TYPO3-Update ist kein optionaler Luxus, sondern eine regelmäßig wiederkehrende Pflichtaufgabe. Jede TYPO3-Version hat ein definiertes End-of-Life-Datum, nach dem keine Sicherheitsupdates mehr erscheinen. Wer Updates aufschiebt, akkumuliert technische Schulden, Extension-Inkompatibilitäten und Sicherheitsrisiken. Dieser Leitfaden beschreibt die TYPO3-Versionshistorie, konkrete Upgrade-Pfade und die typischen Stolperfallen, die bei Major-Updates auftreten.

TYPO3-Versionen im Überblick

TYPO3 folgt einem 18-Monats-Rhythmus für Major-Releases. Jede zweite Version wird als LTS (Long-Term Support) mit drei Jahren regulärem Support veröffentlicht. Danach ist kostenpflichtiger Extended LTS (ELTS) über die TYPO3 GmbH verfügbar.

VersionReleasePHP-AnforderungReguläres EOLELTS EOL
v8 LTSMärz 2017PHP 7.0–7.2März 2020März 2023
v9 LTSOktober 2018PHP 7.2–7.4Oktober 2021Oktober 2024
v10 LTSApril 2020PHP 7.2–7.4April 2023April 2026
v11 LTSOktober 2021PHP 7.4–8.2Oktober 2024Oktober 2027
v12 LTSApril 2023PHP 8.1–8.3April 2026April 2029
v13 LTSOktober 2024PHP 8.2–8.4Oktober 2027Oktober 2030

Was die Tabelle zeigt: Wer heute noch TYPO3 v10 betreibt, hat seit April 2023 keine regulären Sicherheitsupdates mehr erhalten – nur ELTS-Patches, die eine separate Lizenz erfordern und Ende April 2026 auslaufen. TYPO3 v11 hat seit Oktober 2024 nur noch ELTS-Support. Beide Versionen sollten zeitnah auf v12 oder v13 aktualisiert werden.

Warum TYPO3-Updates nicht optional sind

Das Aufschieben von TYPO3-Updates ist eine der häufigsten Ursachen für explodierende IT-Kosten im CMS-Betrieb. Die Gründe, warum Updates unvermeidlich sind:

Sicherheitsrisiken: Nach dem End-of-Life erscheinen keine Sicherheitsupdates mehr (außer über das kostenpflichtige ELTS-Programm). Bekannte Schwachstellen bleiben offen – ein Einfallstor für Angreifer. Für Behörden und regulierte Unternehmen ist der Betrieb einer nicht gepatchten CMS-Version ein Compliance-Verstoß.

PHP-Kompatibilität: TYPO3 v10 unterstützt maximal PHP 7.4 – eine Version, die seit November 2022 kein Security-Support mehr erhält. Der Betrieb einer aktuellen PHP-Version erfordert ein aktuelles TYPO3. Umgekehrt erzwingt ein PHP-Upgrade häufig ein TYPO3-Update.

Extension-Support: Extension-Entwickler stellen den Support für ältere TYPO3-Versionen ein, sobald diese aus dem regulären Support fallen. Wer auf v10 bleibt, findet zunehmend Extensions, die nur noch v12/v13 unterstützen. Die Auswahl schrumpft mit jeder Monat, in dem das Update aufgeschoben wird.

ELTS-Kosten vs. Update-Kosten: ELTS kostet pro Installation und Jahr. Über drei Jahre ELTS-Laufzeit summieren sich die Lizenzkosten – oft auf einen Betrag, der die einmaligen Update-Kosten übersteigt. ELTS ist als Überbrückung gedacht, nicht als Dauerlösung.

Entwicklermarkt: TYPO3-Entwickler, die noch Erfahrung mit v8 oder v9 haben, werden seltener. Ein System auf einer veralteten Version zu betreiben bedeutet, den Pool potenzieller Wartungspartner zu verkleinern.

Performance-Einbußen: Neuere TYPO3-Versionen profitieren von PHP-8.x-Optimierungen (JIT-Compiler, verbesserte Opcache-Nutzung, Union Types) und Core-internen Performance-Verbesserungen. Ein TYPO3 v13 auf PHP 8.3 ist messbar schneller als ein TYPO3 v10 auf PHP 7.4 – bei gleicher Hardware und gleichem Datenvolumen. Für Websites mit hohem Traffic summieren sich diese Unterschiede zu spürbaren Einsparungen bei Serverressourcen.

Funktionale Rückstände: Jede TYPO3-Version bringt neue Funktionen, die Redakteuren und Entwicklern die Arbeit erleichtern. TYPO3 v12 führte die verbesserte Benutzerverwaltung, das Site-Sets-Konzept und native Content-Block-Registrierung ein. TYPO3 v13 brachte Verbesserungen im Asset-Handling, der Backend-Performance und der Accessibility des Backends. Wer auf v10 verbleibt, verzichtet auf vier Jahre funktionaler Weiterentwicklung.

Update-Pfad: Von TYPO3 v10/v11 auf v13

Ein TYPO3 Major-Update ist kein einzelner Klick, sondern ein strukturiertes Projekt. Der empfohlene Pfad für ein Update von v10 oder v11 auf v13:

Schritt 1: Extension-Audit

Vor dem Update steht eine vollständige Bestandsaufnahme aller installierten Extensions:

Für jede Extension, die nicht kompatibel ist, gibt es drei Optionen: (1) Update auf eine kompatible Version, (2) Ersatz durch eine alternative Extension, (3) Eigenentwicklung eines Ersatzes.

Schritt 2: PHP-Kompatibilität sicherstellen

TYPO3 v13 erfordert PHP 8.2+. Wenn das aktuelle System auf PHP 7.4 läuft, muss die PHP-Version schrittweise aktualisiert werden – idealerweise vor dem TYPO3-Update, um PHP-spezifische Fehler isoliert behandeln zu können.

Relevant sind:

Schritt 3: Deprecations bereinigen

Jede TYPO3-Version markiert APIs und Konfigurationsoptionen als deprecated, die in der nächsten Major-Version entfernt werden. TYPO3 bietet dafür ein Deprecation Log im Backend (unter Admin Tools → Upgrade):

Es empfiehlt sich, Deprecations in der aktuellen Version zu bereinigen, bevor das Major-Update durchgeführt wird. So lassen sich Update-Probleme und Deprecation-Probleme getrennt debuggen.

Schritt 4: Upgrade Wizard ausführen

Nach der Aktualisierung der Composer-Abhängigkeiten auf die Zielversion führt der TYPO3 Upgrade Wizard die nötigen Datenbank-Migrationen und Konfigurationsanpassungen durch. Der Wizard ist über das Install Tool oder die CLI (vendor/bin/typo3 upgrade:run) erreichbar und verarbeitet unter anderem:

Jeder Wizard-Schritt lässt sich einzeln ausführen und verifizieren. Für automatisierte Deployments können Wizard-Schritte auch per CLI in der CI/CD-Pipeline ausgeführt werden.

Schritt 5: Testen

Nach dem Update-Durchlauf auf einer Staging-Umgebung folgt ein systematischer Testprozess:

Schritt 6: Deployment

Das Produktiv-Deployment erfolgt containerisiert mit Rollback-Option:

  1. Neues Container-Image mit aktualisiertem TYPO3 bauen
  2. Datenbank-Backup erstellen
  3. Neues Image ausrollen
  4. Upgrade Wizard per CLI ausführen
  5. Cache leeren und warmup durchführen
  6. Monitoring intensivieren (Error-Rate, Response-Time, Crawl-Fehler)
  7. Bei kritischen Problemen: Rollback auf vorheriges Image + Datenbank-Restore

Extension-Kompatibilität prüfen

Die Extension-Kompatibilität ist der zeitintensivste Aspekt eines TYPO3-Updates. Für jede Extension im Projekt sollten folgende Quellen geprüft werden:

Packagist/Composer: composer show -a vendor/extension zeigt verfügbare Versionen und deren TYPO3-Kompatibilität. Ein composer why-not typo3/cms-core:^13 identifiziert Extensions, die das Update blockieren.

Extension-Dokumentation: Viele Extensions dokumentieren ihre Kompatibilitätsmatrix in der README oder auf docs.typo3.org.

GitHub/GitLab: Der Issue-Tracker und die Branches/Tags zeigen, ob aktiv an einer kompatiblen Version gearbeitet wird.

Alternativen für aufgegebene Extensions:

TYPO3 Upgrade Wizard und Install Tool

Der Upgrade Wizard ist das zentrale Werkzeug für Datenmigrationen zwischen TYPO3-Versionen. Jede Major-Version bringt eigene Wizard-Schritte mit:

TYPO3 v11 → v12:

TYPO3 v12 → v13:

Install Tool: Neben dem Upgrade Wizard bietet das Install Tool Funktionen für:

Typische Stolperfallen bei TYPO3-Updates

Aus der Praxis mit Dutzenden TYPO3-Updates lassen sich wiederkehrende Problemkategorien identifizieren:

Breaking Changes in der TCA-Konfiguration: Die Table Configuration Array (TCA) definiert, wie TYPO3 Datenbankfelder im Backend darstellt. Jede Major-Version ändert TCA-Optionen – entfernte Typen, umbenannte Konfigurationsschlüssel, geänderte Rendering-Widgets. Custom Extensions mit eigener TCA-Konfiguration müssen bei jedem Update geprüft und angepasst werden.

Entfernte PHP-APIs: TYPO3 markiert APIs eine Version lang als deprecated und entfernt sie in der nächsten Major-Version. Klassiker: $GLOBALS['TSFE']-Zugriffe, ObjectManager::get(), GeneralUtility::makeInstance() mit geänderten Signaturen. Das Deprecation Log (Admin Tools → Upgrade → Scan Extension Files) identifiziert betroffene Stellen.

TypoScript-Änderungen: TypoScript-Konfigurationen können zwischen Versionen inkompatibel werden. Besonders häufig: geänderte Standardwerte, entfernte Konfigurationsoptionen, Syntax-Verschärfungen. Ab TYPO3 v13 gelten strengere Parsing-Regeln, die toleriert Tippfehler in älteren Versionen nun als Fehler melden.

Fluid-Template-Änderungen: Neue ViewHelper-Argumente, entfernte ViewHelper oder geänderte Ausgabeformate können bestehende Templates brechen. Besonders betroffen: Templates, die auf Core-ViewHelper mit undokumentierten Argumenten zugreifen.

FAL-Änderungen (File Abstraction Layer): Die Dateiverwaltung ändert sich subtil zwischen Versionen – neue Metadaten-Felder, geändertes Crop-Handling, angepasste Bildverarbeitungs-Konfigurationen. FAL-Probleme fallen oft erst auf, wenn Redakteure nach dem Update Bilder bearbeiten.

Scheduler-Tasks und CLI-Commands: TYPO3-Scheduler-Tasks und CLI-Commands ändern ihren Namespace oder ihre Registrierung zwischen Versionen. Automatisierte Prozesse (Cronjobs, CI/CD-Skripte), die TYPO3-CLI-Befehle aufrufen, müssen nach dem Update geprüft werden.

Backend-JavaScript: Ab TYPO3 v12 wurde jQuery als Abhängigkeit im Backend schrittweise entfernt und durch native ES6-Module und Lit-basierte Web Components ersetzt. Extensions, die eigenes Backend-JavaScript mit jQuery-Abhängigkeiten nutzen, müssen ihre Skripte modernisieren. Dieser Aspekt wird häufig übersehen, da er sich nicht in PHP-Deprecation-Logs zeigt, sondern erst im Browser-Testing auffällt.

Composer Mode als Standard: Ab TYPO3 v12 ist der Composer-basierte Installationsmodus der empfohlene Standard. Projekte, die noch im Classic Mode (ohne Composer) betrieben werden, sollten im Zuge eines Major-Updates auf Composer umgestellt werden. Die Umstellung selbst ist ein eigenständiges Migrationsprojekt, das die Verzeichnisstruktur, das Deployment und die Extension-Verwaltung grundlegend ändert.

TYPO3-Updates bei TenMedia

TenMedia führt TYPO3-Updates als strukturierte Projekte durch – mit definiertem Scope, Zeitplan und Qualitätssicherung.

Prozess:

  1. Extension-Audit: Vollständige Kompatibilitätsprüfung aller installierten Extensions. Ergebnis: Liste kompatibler Extensions, zu aktualisierender Extensions und zu ersetzender Extensions.
  2. Staging-Update: Durchführung des kompletten Updates auf einer Staging-Umgebung mit Produktionsdaten (anonymisiert).
  3. Testing: Systematischer Test aller Seitenvorlagen, Extensions, Backend-Funktionen und Redaktionsworkflows.
  4. Korrekturrunde: Behebung aller beim Testing identifizierten Probleme – TCA-Anpassungen, Template-Fixes, Extension-Patches.
  5. Produktiv-Deployment: Containerisiertes Deployment mit Rollback-Option und intensiviertem Monitoring.
  6. Nachbereitung: 14-Tage-Monitoring, Redakteurs-Briefing zu geänderten Backend-Funktionen.

Rollback-Strategie: Bei kritischen Problemen nach dem Produktiv-Update wird das vorherige Container-Image reaktiviert und die Datenbank aus dem Pre-Update-Backup wiederhergestellt. Die gesamte Rollback-Prozedur dauert unter 15 Minuten.

Enthaltene Leistungen im Wartungsvertrag: TYPO3 Patch-Level-Updates (z. B. v13.1 → v13.2) sind in den Wartungsverträgen von TenMedia enthalten. Major-Updates (z. B. v12 → v13) werden als separates Projekt kalkuliert, da der Aufwand je nach Extension-Landschaft und Template-Komplexität variiert.

Die übergeordnete Seite zur TYPO3-Entwicklung ordnet Updates in den Gesamtkontext des TYPO3-Lebenszyklus ein. Details zur laufenden Wartung stehen auf der Seite TYPO3-Wartung. Für Migrationen, die über ein reines Versions-Upgrade hinausgehen, bietet der Leitfaden TYPO3-Migration eine weiterführende Orientierung.

Weiterführende Informationen