TYPO3 Upgrade Checkliste: Ablauf vom Patch bis zum Versionssprung

Eine TYPO3 Upgrade Checkliste folgt beim Versionssprung drei Phasen: vor dem Upgrade, Core-Upgrade und nach dem Upgrade. Gearbeitet wird immer auf einer Kopie der Website, nie auf dem Produktivsystem. Vorab: Systemanforderungen der Zielversion prüfen (PHP, Datenbank, Composer) und ein Backup anlegen. Analyse: Deprecation-Log aktivieren, Extension Scanner einsetzen und die Kompatibilität aller Extensions klären. Core-Upgrade: Versionsangaben in der composer.json anpassen, Composer-Update ausführen, Konflikte auswerten und im Backend anmelden. Nacharbeiten: Datenbank und Daten auf die neue Version migrieren und die Webserver-Konfiguration prüfen. Tests: Templates, Formulare, Suche, Logins, Redakteurs-Workflows, Redirects und mehrsprachige Seiten vor dem Livegang prüfen.

Der Unterschied liegt in der Reichweite des Versionssprungs. Ein Update ist ein Patch innerhalb der installierten Hauptversion, zum Beispiel von 14.3.6 auf 14.3.7. Es enthält nur Bugfixes und Sicherheitskorrekturen, bringt keine neuen Funktionen mit und beeinträchtigt die Abwärtskompatibilität nicht. Bei gepflegten Composer-Projekten dauert es Minuten bis wenige Stunden. Ein Upgrade ist dagegen der Sprung auf eine neue Hauptversion, zum Beispiel von 13.4 auf 14.3. Dabei sind Breaking Changes möglich, und Upgrade Wizards, Extension-Kompatibilität und Tests gewinnen an Gewicht. Beide folgen einer festen Reihenfolge. Sie ist beim Update kurz und beim Upgrade deutlich umfangreicher.

Ein Backup ist die Rückversicherung für jedes Update und Upgrade: Wenn der Composer-Lauf, ein Upgrade Wizard oder die Datenbankanpassung scheitert, lässt sich der alte Stand jederzeit wiederherstellen. Beim Patch-Update steht es deshalb als Schritt 1 am Anfang, beim Major-Upgrade gehört es zur Phase „Vor dem Upgrade“. Dazu gehören zwei Teile: die vollständigen Dateien, also das gesamte Projekt inklusive hochgeladener Dateien, und der SQL-Export der Datenbank mit dem kompletten Datenbestand. Erst wenn beide Teile gesichert sind, sollte der erste Änderungsschritt erfolgen.

Die Regel „erst PHP, dann TYPO3“ trennt zwei Änderungen, die sonst gleichzeitig Fehler verursachen könnten. Zuerst wird PHP auf die höchste Version angehoben, die die aktuelle TYPO3-Version unterstützt. Danach wird PHP stabilisiert, und erst anschließend folgt der eigentliche TYPO3-Sprung.

• Fehler lassen sich eindeutig zuordnen: Tritt ein Problem auf, liegt es entweder an PHP oder am Core-Upgrade.
• Das System läuft schon vor dem Versionssprung auf einer stabilen, aktuellen PHP-Basis.
• Wird PHP zu spät oder über die unterstützte Höchstversion hinaus angehoben, scheitert der Sprung. Beispiel: TYPO3 12 unterstützt höchstens PHP 8.4, PHP 8.5 ist damit inkompatibel.

Die passende PHP-Version der Ausgangs- und Zielversion ist dafür die Grundlage.

Die benötigte PHP-Version hängt immer von der konkreten TYPO3-Hauptversion ab. Sie ermitteln sie in drei Schritten. Erstens prüfen Sie die Systemanforderungen der Zielversion, das ist Schritt 1 vor jedem Upgrade. TYPO3 14 läuft zum Beispiel mit PHP 8.2 bis 8.5, empfohlen sind 8.4 oder 8.5. Zweitens schauen Sie in die Systemanforderungen Ihrer aktuellen TYPO3-Version, denn auch sie hat eine PHP-Obergrenze, die vor dem Sprung nicht überschritten werden darf. Drittens beachten Sie das Support-Ende: PHP 7.4, 8.0 und 8.1 sind außer Support, PHP 8.2 erhält Security-Support nur noch bis 31.12.2026. Prüfen Sie diese Angaben vor jedem Projekt neu, da sie nur Momentaufnahmen sind.

Die Upgrade Wizards migrieren Daten und Konfiguration auf die Strukturen der neuen TYPO3-Version. Sie gehören zum Major-Upgrade, also zum Sprung auf eine neue Hauptversion, nicht zum einfachen Patch-Update. Gestartet werden sie in der Phase „Nach dem Upgrade“ unter Administration → Upgrade (bis v13: Admin Tools → Upgrade), und zwar in dieser Reihenfolge: Zuerst TYPO3- und PHP-Cache leeren, dann den Database Analyzer ausführen, der fehlende Tabellen und Spalten anlegt, anschließend die Upgrade Wizards starten und danach den Cache erneut leeren. Offene Wizards der aktuellen Hauptversion sollten Sie vorher abschließen, sonst blockieren sie später das Upgrade.

Der Extension Scanner gehört zur Phase „Vor dem Upgrade“. Er untersucht eigenen PHP-Code und markiert Stellen, die in der Zielversion nicht mehr funktionieren, etwa entfernte oder veränderte Aufrufe. So lässt sich der Anpassungsaufwand früh abschätzen. Jeder Treffer zeigt eine betroffene Code-Stelle, die Sie prüfen und anpassen oder durch eine Alternative ersetzen. Viele Treffer in einer Extension deuten auf hohen Aufwand hin. Dann klären Sie Update, Ersatz oder Anpassung. Keine Treffer bedeuten nicht automatisch Kompatibilität, denn alles außerhalb von PHP-Code deckt der Scanner nicht ab. Dafür braucht es Fractor oder eine manuelle Prüfung.

TYPO3 Rector ist ein regelbasiertes Werkzeug, das veralteten PHP-Code anhand definierter Regeln automatisch an eine neue TYPO3-Version anpasst. Es ergänzt den Extension Scanner, der problematische Stellen nur markiert. Rector ändert sie auf Wunsch direkt. Seine Aufgabe ist die Migration des PHP-Codes von Extensions und Sitepackage auf die Zielversion. Geplante Änderungen lassen sich vorab anzeigen, etwa mit vendor/bin/typo3-rector process --dry-run, ohne dass etwas verändert wird. So sehen Sie den Umfang der Anpassungen, bevor Sie sie übernehmen. Alles, was nicht PHP-Code ist, liegt außerhalb von Rector und gehört zu Fractor.

Fractor ist ein regelbasiertes Werkzeug, das bei TYPO3-Upgrades veralteten Code automatisch anpasst. Es kümmert sich um TypoScript, FlexForm, Fluid und YAML, während TYPO3 Rector den PHP-Code übernimmt. Das ist wichtig, weil der Extension Scanner nur eigenen PHP-Code prüft. Für alle anderen Dateitypen braucht es Fractor oder eine manuelle Prüfung. Fractor setzt die Änderungen anhand definierter Regeln direkt um, statt Stellen nur zu markieren. Dadurch lassen sich Templates, Konfigurationen und Formulardefinitionen mit überschaubarem Aufwand auf die Zielversion bringen. Es liefert dabei Änderungen, keine Freigabe.

KI unterstützt ein TYPO3-Upgrade als Beschleuniger, nicht als Ersatz für Fachwissen. Die Grundlage bilden regelbasierte Werkzeuge wie TYPO3 Rector und Fractor. Ergänzend setzt die IllusionFACTORY® KI-gestützte Werkzeuge ein. Sie helfen bei der Analyse von Extensions und eigenem Code und beschleunigen die Code-Migration auf die neue Version. So lässt sich früh erkennen, wo viel Aufwand entsteht, und die Umsetzung geht schneller voran. Die KI liefert dabei Vorschläge, die Verantwortung für das Ergebnis liegt bei erfahrenen Entwicklern.

Auch mit Rector, Fractor und KI-gestützten Werkzeugen bleibt die Freigabe beim Entwickler: Alle Ergebnisse werden geprüft und getestet, bevor etwas live geht. Handarbeit bleiben außerdem Konzeptentscheidungen. Bei Gridelements müssen für die Umstellung auf Container Inhaltsstrukturen neu gedacht werden. Bei verwaisten Extensions werden Funktionsumfang, Pflegezustand und Zukunftsfähigkeit gegeneinander abgewogen, um einen Ersatz zu wählen. Gibt es für die Zielversion keine passende Extension-Version, wird der Changelog geklärt und die Extension angepasst oder ersetzt. Erzwungen wird nichts. Auch das Sitepackage braucht angepasste Templates und TypoScript. Zuletzt stehen Funktionstests für Formulare, Login-Bereiche und Redakteurs-Workflows an.

Die meisten Probleme entstehen, wenn die Checkliste nicht Schritt für Schritt abgearbeitet wird. Typische Stolperfallen sind: Installationen ohne Composer müssen vorab migriert werden, was zusätzliche Zeit kostet. Wird Rector auf dem Produktivsystem eingesetzt, landen ungeprüfte Codeänderungen sofort live. Beim Scheduler müssen nicht migrierte Aufgaben mit leerem tasktype neu angelegt werden. Wer diese Punkte früh einplant, vermeidet Verzögerungen und Überraschungen kurz vor dem Livegang.

Die IllusionFACTORY® begleitet Ihr TYPO3-Upgrade in fünf Phasen vom Check bis zum Livegang. Phase 1, Check: Wir analysieren Version, Extensions und Systemvoraussetzungen, Sie liefern eine Extension-Liste. Phase 2, Kopie und Backup: Wir legen eine gesicherte Arbeitskopie samt Datenbank an, Sie stellen die Zugangsdaten bereit. Phase 3, Upgrade: Wir führen das Core-Upgrade durch, lösen Abhängigkeiten, passen Extensions und Sitepackage an und migrieren Code und Daten mit unseren Werkzeugen. Phase 4, Test: Wir prüfen mit Ihren Testfällen aus dem Redaktionsalltag und eigenen Funktionstests. Phase 5, Livegang: Wir übernehmen die geprüfte Version ins Produktivsystem, für Ihre Redakteure gilt ein kurzer Content-Freeze.

Die IllusionFACTORY® bietet Aktionspreise für den Wechsel auf TYPO3 14 LTS, die sich nach Ihrer Ausgangsversion richten. Bei TYPO3 13 beginnen sie ab 1.200 € zzgl. MwSt. Je älter die Ausgangsversion ist, desto höher fällt der Einstiegspreis aus. Bei TYPO3 6 liegt er bei 3.000 €. Maßgeblich ist immer der Endpreis nach individueller Prüfung Ihrer Website. Der Endpreis hängt vor allem von diesen Faktoren ab: der Ausgangsversion, der Projektgröße und dem Umfang des Sitepackages, der Anzahl eigener und fremder Extensions sowie einer eventuell nötigen Composer-Migration.

Ja, ein TYPO3-Update ist staatlich förderfähig. Je nach Firmensitz übernimmt die Förderung bis zu 80 % der Kosten. Ob Ihr Unternehmen die Voraussetzungen erfüllt, klärt die IllusionFACTORY® im ersten Gespräch. Den Preis für Ihre Installation lassen Sie so prüfen: Wählen Sie über „Preis für Ihre TYPO3-Version prüfen“ Ihre Ausgangsversion aus. Sie sehen dann den Aktionspreis für den Wechsel auf TYPO3 14 LTS, der zu Ihrer Version passt. Anschließend fragen Sie das Angebot direkt bei der IllusionFACTORY® an.