Der Weg (zu) einer TYPO3-LTS-Version: Major Releases, Minor Releases und Patches
TYPO3 unterscheidet zwischen Major Releases und Minor Releases. Die erste Zahl einer Versionsnummer kennzeichnet die Major-Version, z. B. steht TYPO3 13 LTS für die Version 13.4. Major Releases bringen bedeutende Neuerungen im Vergleich zur vorherigen Hauptversion. Die zweite Zahl gibt die Minor-Version an. Vor der stabilen LTS-Version durchläuft eine neue Major-Version mehrere Entwicklungsphasen, in denen neue Funktionen hinzugefügt und Fehler behoben werden. Die Versionen vor der LTS-Version werden als Sprint Releases bezeichnet – im Fall von TYPO3 v13 sind das die Versionen 13.0 bis 13.3.
Die erste stabile Minor-Version ist die LTS-Version (Long Term Support), die langfristig gewartet wird und sämtliche neuen Features sowie Fehlerkorrekturen aus den Sprint Releases integriert. Daher empfiehlt sich ein Upgrade erst mit der Veröffentlichung der LTS-Version, da diese offiziellen Support und langfristige Stabilität bietet.
Nach der Veröffentlichung der LTS-Version erscheinen nur noch Patches, die durch die dritte Zahl in der Versionsnummer gekennzeichnet sind. Diese Updates enthalten hauptsächlich Fehlerbehebungen und Sicherheitsupdates. Zum Beispiel steht das aktuelle TYPO3 13.4.5 (Stand: Februar 2025) für die fünfte Patch-Version von TYPO3 13 LTS. Da in den ersten Monaten nach dem Release einer LTS-Version oft viele Patches veröffentlicht werden, ist es ratsam, mit dem Update einer bestehenden Instanz einige Zeit zu warten, bis die anfänglichen Fehlerkorrekturen implementiert wurden.
Unterschied zwischen Updates, Upgrades und Versionssprüngen
- Ein Update bezeichnet den Übergang von einer Patch-Version zur nächsten, z. B. von 13.4.4 auf 13.4.5.
- Ein Upgrade ist der Wechsel zwischen Major-Versionen, z. B. von TYPO3 12 auf TYPO3 13.
- Ein Versionssprung erfolgt, wenn mehrere Major-Versionen übersprungen werden, z. B. beim Upgrade von TYPO3 10 auf TYPO3 13. Dieser Prozess ist aufwendiger, da mehrere Zwischenschritte nötig sind, um Abwärtskompatibilität sicherzustellen.
Wir schauen uns nun den Ablauf eines TYPO3 v13 Upgrades detaillierter an – mit grundlegenden Schritten, die für jedes TYPO3-Upgrade relevant sind.
Vorbereitungen für ein TYPO3 Upgrade
Backup
Upgrades sollten niemals direkt auf einer Live-Instanz durchgeführt werden sollten. Der Grund dafür ist einfach: Jedes Upgrade birgt potenzielle Risiken, und nicht alle Probleme lassen sich im Voraus vorhersehen. Um auf der sicheren Seite zu sein, sollte zunächst eine Kopie der bestehenden Instanz erstellt werden, auf der das Upgrade durchgeführt wird. Zusätzlich ist es ratsam, ein vollständiges Backup bereitzuhalten, um im Falle unerwarteter Fehler oder Datenverluste die ursprüngliche Version schnell wiederherstellen zu können. Ein vollständiges Backup umfasst:
- alle Dateien der TYPO3-Installation (per FTP, SCP, rsync oder einer anderen Methode gesichert)
- gesamte Datenbank als SQL-Datei exportiert
Während des gesamten Upgrade-Vorgangs sollte ein Content-Freeze eingehalten werden, sodass keine Inhalte doppelt eingepflegt werden müssen – einmal vor und einmal nach dem Upgrade. Detaillierte Informationen zu diesem und weiteren wichtigen Schritten finden Sie auch auf der offiziellen TYPO3 Website. Bevor man mit der Kopie arbeitet, sollte man prüfen, ob die Kopie genauso funktioniert wie die Live-Instanz.
Systemanforderungen prüfen
Bevor das eigentliche Upgrade beginnt, sollten die Systemanforderungen für die neue TYPO3-Version geprüft werden. Neben der PHP-Version müssen auch die Datenbank, der Webserver und weitere Serverkomponenten kompatibel sein. Für TYPO3 v13 ist z. B. PHP 8.2 eine Mindestanforderung. Alle Systemanforderungen für TYPO3 13 finden Sie unter get.typo3.org. Falls erforderlich, sollten diese Komponenten vor dem TYPO3-Upgrade aktualisiert werden, um Kompatibilitätsprobleme zu vermeiden.
Extensions prüfen & aktualisieren
Ein zentraler Schritt vor dem Upgrade ist die Überprüfung der installierten Extensions auf ihre Kompatibilität mit der neuen TYPO3-Version.
1. Deprecation-Log & Extension Scanner nutzen
Der Extension-Scanner im Install Tool hilft, veraltete oder inkompatible Funktionen zu erkennen. Das Deprecation-Log sollte einige Tage aktiviert sein, um veraltete Code-Stellen zu identifizieren und anschließend zu lösen.
2. Erweiterungen aktualisieren oder ersetzen
Alle aktiven Extensions sollten auf die höchste für die aktuelle TYPO3-Version verfügbare Version aktualisiert werden. Falls eine Erweiterung nicht mit der neuen TYPO3-Version kompatibel ist, gibt es drei Optionen:
- Nach einer alternativen Extension suchen.
- Falls es sich um eine eigene Erweiterung handelt, diese anpassen.
- Prüfen, ob sie trotz Inkompatibilitätswarnung funktioniert (manchmal sind Extensions kompatibel, obwohl sie nicht als solche markiert sind).
3. Nicht mehr benötigte Erweiterungen entfernen
Nicht mehr genutzte Extensions sollten vor dem Upgrade gelöscht werden, um den Aufwand zu reduzieren. Manche Erweiterungen müssen vor dem Upgrade deaktiviert und erst danach aktualisiert und wieder aktiviert werden.
4. PHP-Kompatibilität der Extensions prüfen
Manche Extensions sind mit der neuen TYPO3-Version kompatibel, aber nicht mit der erforderlichen PHP-Version. In solchen Fällen muss entweder eine ältere PHP-Version verwendet werden oder auf die betroffene Extension verzichtet werden.
Referenz-Index überprüfen
Der globale Referenz-Index verwaltet Verknüpfungen zwischen Inhaltselementen und Dateien. Das Überprüfen und Aktualisieren dieses Index kann auf zwei Wegen erfolgen: entweder über die Kommandozeile (CLI) oder über das Modul DB-Überprüfung (System-Module). Da der Vorgang, besonders bei großen Websites mit vielen Seiten und Dateien, viel Zeit in Anspruch nehmen kann und nicht regelmäßig durchgeführt werden muss, wird die Methode über die Kommandozeile empfohlen. Der DB-Check ist besonders für kleine Websites mit wenigen Unterseiten und Dateien eine Alternative.
Der globale Referenz-Index verwaltet Verknüpfungen zwischen Inhaltselementen, Seiten und Dateien. Um Inkonsistenzen in der Datenbank zu vermeiden, sollte der Index vor dem Upgrade aktualisiert werden.
- über Kommandozeile (CLI): Diese Methode ist bei großen Websites empfehlenswert, da sie schneller und zuverlässiger ist.
- über Backend-Modul DB-Überprüfung (Systemmodule): Eine Alternative für kleinere TYPO3-Instanzen mit wenigen Seiten und Dateien.
Die regelmäßige Aktualisierung des Referenz-Indexes stellt sicher, dass alle internen Verknüpfungen korrekt sind und potenzielle Fehler frühzeitig erkannt werden.
Changelog & Breaking Changes prüfen
Dieser Schritt ist optional, aber es ist vorteilhaft, ein Upgrade sorgfältig vorzubereiten. Der Changelog einer TYPO3-Version enthält wichtige Informationen zu neuen Features, Bugfixes und potenziellen Breaking Changes. Besonders Breaking Changes sollten vor dem Upgrade genau geprüft werden, da sie bestehende Funktionalitäten beeinflussen können. Die Changelogs lassen sich über den Extension Scanner einsehen oder auf der offiziellen TYPO3 Website nachlesen. Im Extension Scanner können Änderungen nach Kategorie gefiltert und wie eine To-Do-Liste abgearbeitet werden. Empfohlen wird, sich mindestens die Breaking Changes und die Kategorie Important anzusehen, um notwendige Anpassungen frühzeitig planen zu können.
Globale Extensions in lokale Extension konvertieren
Mit TYPO3 v12 wurde die Unterstützung für globale Extensions entfernt. Falls noch globale Erweiterungen genutzt werden, müssen diese in lokale Extensions umgewandelt werden.
- Deinstallation der globalen Extension über das Backend-Modul Extensions.
- Löschen der Dateien der Extension aus dem Verzeichnis
typo3/ext/
. - Neuinstallation der Extension aus dem TYPO3 Extension Repository (TER), wodurch sie in
typo3conf/ext/
abgelegt wird.
Die Umstellung auf lokale Extensions stellt sicher, dass die Erweiterungen mit zukünftigen TYPO3-Versionen kompatibel bleiben und weiterhin gepflegt werden können.
TYPO3-Core Upgrade
Um ein Upgrade Ihrer TYPO3-Installation auf Version 13 durchzuführen, können Sie die TYPO3-Quellen entweder über Composer oder direkt von der offiziellen TYPO3-Website beziehen. Die bevorzugte Methode ist die Verwendung von Composer, da sie eine bessere Verwaltung von Abhängigkeiten und zukünftigen Updates ermöglicht. Alle Informationen zum TYPO3 v13 Core Update finden Sie auch auf der offiziellen Dokumentation zur Version 13.
Wichtige Hinweise (siehe auch Vorbereitungen): Sicher zu stellen ist, dass die verwendeten Server die Anforderungen der neuen TYPO3-Version erfüllt, insbesondere hinsichtlich der PHP- und Datenbankversionen. Wichtig ist es zudem, die Breaking Changes für TYPO3 v13 zu beachten, die möglicherweise Anpassungen in den Extensions oder dem Setup erfordern. Vor jedem Upgrade sollte ein vollständiges Backup der Installation und Datenbank erstellt werden, um im Falle von Problemen eine Wiederherstellung zu ermöglichen. Mit TYPO3 v12 wurde das Paket typo3/cms-recordlist
in typo3/cms-backend
eingegliedert. Mit TYPO3 v13 wurde das Paket typo3/cms-t3editor
in typo3/cms-backend
integriert. Wenn Sie also eines der beiden Pakete installiert haben, entfernen Sie sie in Ihrer composer.json
-Datei, bevor Sie das Upgrade durchführen.
Führen Sie den Befehl composer info typo3/*
aus, um alle derzeit installierten TYPO3-Pakete aufzulisten. Jedes Paket muss während des Upgrades auf eine andere Hauptversion aktualisiert werden. Notieren Sie sich die installierten Pakete, insbesondere optionale Extensions, die möglicherweise nicht standardmäßig in der neuen Version enthalten sind. Um ein Composer-Paket zu aktualisieren, führen Sie es composer require
mit dem Paketnamen und der Versionsnummer aus. Mit dem Composer Helper Tools kann ein Upgrade-Kommando bequem erstellt werden. Zu beachten ist, dass bei einer typischen Installation Abhängigkeitsfehler auftreten, die gelöst werden müssen.
Nach dem Core-Upgrade
Nach dem erfolgreichen Upgrade Ihrer TYPO3-Installation auf Version 13 sind einige Nachbereitungen erforderlich, um sicherzustellen, dass das System ordnungsgemäß funktioniert. Alle notwendigen Schritte, die nach dem TYPO3-Core-Update durchgeführt werden müssen, finden man auch auf der offiziellen TYPO3 Website.
Upgrade Wizard ausführen
Nach dem TYPO3-Core-Update sollte der Upgrade Wizard im Install Tool durchlaufen werden. Das Install Tool lässt sich aufrufen über ihre-domain.de/typo3/install.php
. Dort navigiert man zum Abschnitt Upgrade und wählt den Upgrade Wizard. Dieser führt durch mehrere Schritte, beginnend mit dem Anlegen fehlender Datenbanktabellen und -felder. Es wird empfohlen, alle vorgeschlagenen Schritte des Wizards sorgfältig zu prüfen und entsprechend auszuführen. Einige Wizards betreffen optionale Funktionen, die für die aktuelle Installation möglicherweise nicht relevant sind, diese kann man überspringen.
Alle Aktualisierungen lassen sich auch gleichzeitig über die Kommandozeile (CLI) durchführen, was insbesondere bei umfangreichen Installationen vorteilhaft sein kann.
Datenbank analysieren und anpassen
Nach Abschluss des Upgrade Wizards sollte die Datenbankstruktur analysiert und an die Anforderungen der neuen TYPO3-Version angepasst werden. Im Install Tool geht man dafür zum Bereich Wartung und wählt Sie Datenbank analysieren. Das System zeigt eine Liste von Änderungen an, die durchgeführt werden sollten, um die Datenbank auf den aktuellen Stand zu bringen. Zu beachten sind besonders Tabellen oder Felder, die als veraltet markiert sind. TYPO3 benennt solche Elemente zunächst mit dem Präfix zzz_deleted_*
um, bevor sie endgültig entfernt werden. Eine sorgfältige Prüfung, ob diese Elemente nicht mehr benötigt werden, ist wichtig, bevor man sie löscht.
Backend-Benutzereinstellungen zurücksetzen
Es kann sinnvoll sein, die Backend-Benutzereinstellungen zurückzusetzen, um mögliche Inkompatibilitäten nach dem Upgrade zu vermeiden. Das kann insbesondere dann hilfreich sein, wenn Benutzer individuelle Einstellungen vorgenommen haben, die mit der neuen Version nicht mehr kompatibel sind. Im Install Tool findet sich unter Wartung die Option Benutzereinstellungen zurücksetzen. Rersönliche Einstellungen der Benutzer können dabei verloren gehen.
Caches leeren und temporäre Dateien entfernen
Nach dem Upgrade ist es essenziell, alle Caches zu leeren, um sicherzustellen, dass keine veralteten Daten verwendet werden. Im Backend geht man dafür zu Admin-Werkzeuge > Wartung und klicken Sie auf Cache leeren. Zusätzlich sollten temporäre Dateien entfernt werden. Im selben Modul befindet sich die Option Temporäre Assets entfernen, mit der man nicht mehr benötigte temporäre Dateien löschen kann. Dies stellt sicher, dass das System mit den aktuellen Daten arbeitet und verhindert mögliche Konflikte durch alte Dateien.
Sprachpakete aktualisieren
Nach dem Upgrade sollten die Sprachpakete aktualisiert werden, um sicherzustellen, dass alle Backend-Texte in der gewünschten Sprache verfügbar sind. Im Install Tool unter Wartung befindet sich der Bereich Sprachpakete verwalten. Dort sollten die installierten Sprachen aktualisiert werden, um fehlende Übersetzungen zu ergänzen und sicherzustellen, dass das Backend wie gewohnt genutzt werden kann.
Durch die sorgfältige Durchführung dieser Nachbereitungen stellen man sicher, dass die TYPO3-Installation nach dem Upgrade stabil und effizient läuft.
Comments