TYPO3
TYPO3-Update Schritt für Schritt — und was tun, wenn danach etwas nicht läuft
Minor-Update oder Major-Upgrade? Wie ein TYPO3-Update abläuft, was der Upgrade-Wizard tut, wie Extensions mitziehen — und was hilft, wenn die Seite danach nicht mehr läuft.
· 4 Min.
Minor-Update oder Major-Upgrade?
Ein Update bleibt in derselben Hauptversion, etwa von 13.4.2 auf 13.4.5. Es bringt Sicherheits- und Fehlerkorrekturen, ändert nichts an der Bedienung und ist Routine — solange es regelmäßig passiert.
Ein Upgrade wechselt die Hauptversion, etwa von 12 auf 13 oder von 13 auf 14. Dann ändern sich Schnittstellen, an denen Extensions und eigener Code hängen. Das ist kein Klick, sondern ein kleines Projekt: prüfen, anpassen, testen, umschalten.
Läuft Ihre Website schon nicht mehr? Rufen Sie an unter +49 5732 68 69 260 — wir sehen uns den Fall sofort an, auch ohne Wartungsvertrag.
Vor dem Update: die Checkliste
- Vollständiges Backup von Dateien und Datenbank — eines, das sich auch zurückspielen lässt.
- Eine Kopie der Website auf einer Testadresse. Das Update läuft zuerst dort, nie direkt live.
- PHP-Version prüfen: Jede TYPO3-Version setzt einen bestimmten PHP-Bereich voraus. Passt der Server nicht, muss zuerst PHP aktualisiert werden.
- Extensions prüfen: Gibt es für jede installierte Erweiterung eine Version für die Zielversion? Für eigene Extensions zeigt der Extension Scanner im Admin-Bereich, welche Stellen angepasst werden müssen.
- Änderungen lesen: Der Changelog der Zielversion listet „Breaking Changes“ und veraltete Funktionen auf.
- Zeitfenster festlegen: nicht am Freitagnachmittag und nicht vor der wichtigsten Kampagne des Jahres.
Schritt für Schritt: das Core-Update mit Composer
In einer Composer-Installation läuft ein Minor-Update auf der Kopie mit einem Befehl:
composer update "typo3/cms-*" --with-all-dependencies
Für ein Major-Upgrade werden zuerst die Versionsangaben aller TYPO3-Pakete in der composer.json angehoben, etwa auf ^14.3; danach folgt ein composer update mit allen Abhängigkeiten. Anschließend:
- Datenbank abgleichen: im Admin-Bereich unter „Maintenance“ die Datenbankstruktur analysieren und die Änderungen übernehmen.
- Upgrade-Wizards ausführen: Unter „Upgrade“ zeigt TYPO3, welche Daten migriert werden müssen. Auf der Kommandozeile erledigt das vendor/bin/typo3 upgrade:run.
- Caches leeren: im Admin-Bereich oder mit vendor/bin/typo3 cache:flush.
- Sprachpakete aktualisieren, damit Backend und Meldungen wieder vollständig übersetzt sind.
- Testen: Formulare, Suche, Menüs, Bilder, Backend-Login und Redakteursrechte — auf der Kopie, bevor live umgeschaltet wird.
Ältere Installationen ohne Composer werden über den Austausch des TYPO3-Quellcodes aktualisiert. Das funktioniert, ist aber fehleranfälliger — beim nächsten Major-Upgrade lohnt der Umstieg auf Composer.
Extensions aktualisieren
Die meisten Probleme bei einem Upgrade entstehen nicht im TYPO3-Kern, sondern in Erweiterungen:
- Extensions aus dem offiziellen Verzeichnis bekommen meist eine neue Version für die neue Hauptversion. Fehlt sie, braucht es Ersatz.
- Eigene Extensions müssen an geänderte Schnittstellen angepasst werden. Der Extension Scanner zeigt die betroffenen Stellen — die Arbeit nimmt er einem nicht ab.
- Verwaiste Extensions, die niemand mehr pflegt, werden ersetzt oder neu gebaut. Sonst blockieren sie jedes weitere Update.
Deshalb können sich zwei Websites mit derselben Versionsnummer im Aufwand um ein Vielfaches unterscheiden.
Upgrade-Pfade: von 6.2, 7, 8 oder 9 auf die aktuelle Version
Ein Upgrade führt über jede LTS-Version, denn die Upgrade-Wizards einer Version setzen den Stand der vorherigen voraus:
6.2 → 7.6 → 8.7 → 9.5 → 10.4 → 11.5 → 12.4 → 13.4 → 14.3
Jede Stufe heißt: Code anpassen, Wizards ausführen, testen. Bei sehr alten Installationen ist ein Neuaufbau mit Übernahme der Inhalte oft günstiger als fünf Upgrades hintereinander. Das prüfen wir, bevor Sie sich entscheiden.
Typische Fehler nach dem Update — und ihre Ursachen
- Weiße Seite: Meist ein PHP-Fehler, weil eine Extension nicht zur neuen TYPO3- oder PHP-Version passt. Die Ursache steht im TYPO3-Log — in Composer-Installationen unter var/log, in klassischen unter typo3temp/var/log.
- „Oops, an error occurred!“: TYPO3 fängt einen Fehler ab und zeigt Besuchern nur diese Meldung mit einem Code. Die Details dazu stehen im Log; meist ruft eine Extension oder ein Template eine Funktion auf, die es nicht mehr gibt.
- Fehlende Inhalte: Inhaltselemente einer Extension, die nicht mehr geladen wird, oder ein Template, das nicht an geänderte Strukturen angepasst wurde.
- Fehlende Backend-Module: Extensions, die mit der neuen Version nicht kompatibel sind, werden nicht geladen — ihre Module fehlen.
Wann Sie Hilfe holen sollten
Spätestens, wenn die Live-Seite betroffen ist. Dann gilt: nichts überschreiben — keine weiteren Updates einspielen, keine Dateien löschen, kein Backup überschreiben. Halten Sie die Zugänge zu Hoster, Datenbank und Backend bereit und notieren Sie, was kurz vor dem Fehler passiert ist.
Rufen Sie an unter +49 5732 68 69 260 (werktags 9 bis 17 Uhr) — wir sehen uns Ihre Seite sofort an, auch ohne Wartungsvertrag. Außerhalb der Bürozeiten erreichen Sie uns über die Notfall-Hilfe.
Kurz gesagt
Updates innerhalb einer Version sind Routine, Upgrades auf eine neue Hauptversion ein Projekt. Beides gehört auf eine Kopie, mit Backup davor. Die meisten Fehler stecken in Extensions, die Ursache steht im Log. Und wer von einer sehr alten Version kommt, sollte vor dem fünften Upgrade in Folge einen Neuaufbau durchrechnen.
Update lieber abgeben? Kleine Updates sind in der TYPO3-Wartung enthalten, ein Major-Upgrade ist ein eigenes Projekt mit Angebot — wie wir dabei vorgehen, steht auf TYPO3-Update.