TYPO3 Migration: Was Unternehmen beim Wechsel auf eine neue Version beachten sollten

Eine TYPO3-Migration steht selten aus reiner Lust an Veränderung auf dem Plan. Meistens ist es der Support-Zeitraum einer alten Version, der ausläuft, oder ein Sicherheitsupdate, das nur noch für aktuelle Releases bereitgestellt wird.

Wer mit TYPO3 6 oder 8 arbeitet und plötzlich merkt, dass Extensions nicht mehr gepflegt werden oder der Hosting-Anbieter auf eine neuere PHP-Version umstellt, steht vor der Frage: Wie geht ein Versionswechsel eigentlich vonstatten, ohne dass die Website tagelang offline ist oder wichtige Inhalte verloren gehen?

Die gute Nachricht zuerst: TYPO3 ist für seine strukturierten Upgrade-Pfade bekannt. Die schlechte Nachricht: Ein Sprung über mehrere Major-Versionen hinweg ist etwas völlig anderes als ein Update von TYPO3 11 auf 12. Je größer der Abstand zwischen Ausgangs- und Zielversion, desto mehr Vorarbeit ist nötig.

Warum der Zeitpunkt der Migration wichtig ist

TYPO3 folgt einem LTS-Modell (Long Term Support), bei dem bestimmte Versionen über mehrere Jahre mit Sicherheitsupdates versorgt werden. Sobald eine Version aus dem Support fällt, bleibt die Website zwar technisch funktionsfähig, erhält aber keine Patches mehr für neu entdeckte Schwachstellen. Für Unternehmen mit sensiblen Kundendaten oder Formularen ist das ein Risiko, das sich nicht einfach aussitzen lässt.

Ein zweiter Aspekt betrifft die Extension-Landschaft. Viele Drittanbieter-Extensions werden nur für eine begrenzte Zahl an TYPO3-Versionen aktiv gepflegt. Wartet man zu lange mit der Migration, kann es passieren, dass eine benötigte Erweiterung für die Zielversion gar nicht mehr existiert oder komplett neu entwickelt werden muss. Frühzeitiges Planen verschafft hier deutlich mehr Spielraum.

Der Unterschied zwischen Update und Migration

Im Alltag werden die Begriffe Update und Migration oft synonym verwendet, technisch gesehen sind sie aber nicht dasselbe. Ein Update innerhalb derselben Major-Version (etwa von 12.2 auf 12.4) bringt in der Regel Bugfixes und kleinere Verbesserungen, ohne dass sich an der Grundarchitektur etwas ändert.

Eine Migration über Major-Versionen hinweg (zum Beispiel von TYPO3 9 auf TYPO3 12) kann dagegen tiefgreifende Änderungen an der Datenbankstruktur, den APIs und der Art, wie Extensions eingebunden werden, mit sich bringen.

Gerade bei älteren Installationen, die noch mit TypoScript-basierten Templates oder veralteten Fluid-Versionen arbeiten, reicht ein einfacher Versionssprung nicht aus. Hier braucht es häufig eine schrittweise Migration über mehrere Zwischenversionen, weil TYPO3 offiziell nur den Wechsel zur jeweils nächsten LTS-Version unterstützt.

Bestandsaufnahme vor dem eigentlichen Wechsel

Bevor überhaupt eine neue TYPO3-Version installiert wird, lohnt sich eine ehrliche Inventur der bestehenden Seite. Dazu gehört zu prüfen, welche Extensions aktiv im Einsatz sind und ob für diese eine kompatible Version für das Zielsystem existiert. Manche Erweiterungen werden vom Entwickler nicht mehr aktualisiert, andere haben ihre Funktionalität inzwischen in den TYPO3-Core übernommen, wodurch sie überflüssig werden.

Ebenso wichtig ist ein Blick auf individuelle Anpassungen: selbst geschriebene Extensions, angepasste Templates oder eigene TypoScript-Konstrukte. Je individueller eine Installation über die Jahre gewachsen ist, desto mehr Testaufwand entsteht bei der Migration.

Ein Unternehmen, das seine TYPO3-Seite seit acht Jahren kontinuierlich erweitert hat, sollte realistisch einplanen, dass die Migration mehrere Wochen in Anspruch nehmen kann, während eine schlankere, weitgehend im Standard gebliebene Installation deutlich schneller umgezogen ist.

Typische Stolpersteine bei der Migration

Ein häufiges Problem entsteht bei der Datenbankstruktur. Neuere TYPO3-Versionen erwarten teilweise andere Tabellenfelder oder haben veraltete Felder entfernt. Ohne die passenden Upgrade-Wizards, die TYPO3 für genau diesen Zweck mitliefert, können Inhalte inkonsistent werden oder ganz verloren gehen. Diese Wizards sollten nicht übersprungen werden, auch wenn sie zusätzliche Zeit kosten.

Ein weiterer Punkt betrifft das Frontend-Rendering. Wer noch mit dem alten TypoScript-basierten Templating arbeitet, muss beim Wechsel auf aktuelle Versionen häufig auf Fluid-Templates umstellen. Das ist kein reiner Kopiervorgang, sondern erfordert, dass Templates strukturell neu aufgebaut werden. Bei komplexen Layouts mit vielen Content-Elementen kann das einen erheblichen Teil des gesamten Migrationsaufwands ausmachen.

Auch die PHP-Kompatibilität wird oft unterschätzt. Jede neue TYPO3-Version setzt in der Regel eine neuere PHP-Mindestversion voraus. Läuft der Server noch mit einer älteren PHP-Version, muss zunächst das Hosting-Umfeld angepasst werden, bevor die eigentliche TYPO3-Migration überhaupt beginnen kann. Diese Abhängigkeit wird in Projektplänen häufig übersehen und führt dann zu unerwarteten Verzögerungen kurz vor dem geplanten Go-Live.

Testumgebung und schrittweises Vorgehen

Eine Migration sollte nie direkt auf dem Produktivsystem stattfinden. Sinnvoll ist eine separate Staging-Umgebung, in der die neue Version installiert, die Datenbank migriert und alle Extensions getestet werden können, ohne dass die Live-Website davon betroffen ist. Erst wenn dort alle zentralen Funktionen wie Formulare, Suchfunktionen, mehrsprachige Inhalte und individuelle Content-Elemente zuverlässig funktionieren, ist der Zeitpunkt für den eigentlichen Wechsel gekommen.

Bei größeren Versionssprüngen empfiehlt sich ein schrittweises Vorgehen: erst der Wechsel auf die nächste unterstützte LTS-Version, dann Tests, dann der nächste Schritt. Das mag aufwendiger wirken als ein einzelner großer Sprung, reduziert aber das Risiko, mehrere unbekannte Fehlerquellen gleichzeitig lösen zu müssen. Gerade bei Installationen mit gewachsener Extension-Landschaft zahlt sich diese Geduld meist aus.

Wann externe Unterstützung sinnvoll ist

Nicht jedes Unternehmen hat intern die Kapazität, eine TYPO3-Migration nebenbei zu stemmen. Wer sich unsicher ist, ob die eigene Installation für einen größeren Versionssprung bereit ist, oder wer bereits weiß, dass umfangreiche Custom-Extensions angepasst werden müssen, sollte frühzeitig prüfen, ob es sinnvoller ist, TYPO3 Entwickler einstellen zu lassen, statt das Projekt intern mit begrenzten TYPO3-Kenntnissen zu stemmen.

Gerade bei komplexen Systemlandschaften mit vielen Abhängigkeiten macht erfahrene Unterstützung häufig den Unterschied zwischen einer reibungslosen Migration und wochenlangem Nacharbeiten.

Das gilt besonders dann, wenn die Website tief in andere Systeme eingebunden ist, etwa über Schnittstellen zu einem CRM oder Warenwirtschaftssystem. Solche Integrationen müssen bei einer Migration mitgedacht werden, da sich API-Strukturen zwischen TYPO3-Versionen ändern können.

Nach der Migration: Kontrolle statt Aufatmen

Sobald die neue Version live ist, endet die Arbeit nicht sofort. In den ersten Tagen nach dem Go-Live lohnt sich eine engmaschige Kontrolle der Website: Funktionieren alle Formulare wie gewohnt, laden Bilder und Dateien korrekt, sind SEO-relevante Metadaten und URLs erhalten geblieben?

Gerade bei Weiterleitungen und URL-Strukturen können sich durch Migrationen unbemerkte Änderungen einschleichen, die sich erst nach einigen Tagen im Suchmaschinen-Ranking bemerkbar machen.

Ein letzter praktischer Hinweis: Backups vor jedem einzelnen Migrationsschritt sind kein optionaler Zusatzschritt, sondern die Absicherung, die eine Rückkehr zum vorherigen Stand ermöglicht, falls doch etwas nicht wie geplant läuft. Wer diesen Schritt konsequent einhält, nimmt sich selbst den größten Teil des Risikos, das mit einer TYPO3-Migration verbunden ist.