TYPO3 auf Composer umstellen: Warum, wann und wie

Kurz gesagt: TYPO3 lässt sich klassisch (Legacy-Modus, Dateien per FTP) oder über Composer installieren. Für die aktuellen Versionen 13 und 14 ist Composer der empfohlene Weg, und viele Extensions werden zuerst oder nur noch über Composer bereitgestellt. Die Umstellung lohnt sich am besten zusammen mit einem Versions-Update. Inhalte, Seitenbaum und Benutzer bleiben dabei erhalten, nur die Dateistruktur ändert sich.

Viele TYPO3-Seiten wurden vor Jahren klassisch eingerichtet: ein Paket von typo3.org heruntergeladen, per FTP hochgeladen, Extensions über den Extension Manager installiert. Das funktioniert auch heute noch. Spätestens beim Update auf TYPO3 13 oder 14 stellt sich aber die Frage, ob man nicht gleich auf Composer umsteigt.

Die Menünamen beziehen sich auf TYPO3 bis Version 13. In TYPO3 14 wurden einige Backend-Module umbenannt, etwa „Admin Tools“ in „Administration“ bzw. „System“.

Was ist der Unterschied?

Legacy-Modus: Der TYPO3-Kern liegt als Dateipaket auf dem Server, Extensions in typo3conf/ext/. Updates bedeuten: neues Paket hochladen, Symlinks umstellen, Extensions einzeln aktualisieren.

Composer-Modus: Eine Datei composer.json beschreibt, welche TYPO3-Version und welche Extensions in welcher Version installiert sind. Composer lädt alles herunter und achtet darauf, dass die Versionen zusammenpassen. Updates sind ein Befehl plus Test, und die Konfiguration lässt sich in Git versionieren.

Warum sich der Umstieg lohnt

• Abhängigkeiten werden geprüft. Composer verweigert die Installation, wenn eine Extension nicht zur TYPO3-Version passt, statt dass es später auf der Live-Seite knallt.
• Nachvollziehbare Updates. Welche Version läuft, steht in einer Datei, nicht nur im Backend.
• Bessere Verfügbarkeit von Extensions. Viele Extensions erscheinen zuerst auf Packagist, dem Verzeichnis für Composer-Pakete.
• Sicherere Struktur. Im Composer-Modus zeigt der Webserver nur auf den Ordner public/. Konfiguration, Logs und Code liegen außerhalb und sind aus dem Internet nicht erreichbar.

Was Sie dafür brauchen

• SSH-Zugang zum Server oder eine Möglichkeit, lokal zu bauen und das Ergebnis hochzuladen. Viele Hoster bieten SSH inzwischen auch in kleineren Paketen an.
• Die Möglichkeit, das Wurzelverzeichnis (Document Root) der Domain auf den Ordner public/ zu stellen. Das geht im Kundenmenü der meisten Hoster.
• Eine Liste aller installierten Extensions mit Versionen und Herkunft: aus dem TER, von Packagist oder selbst entwickelt.

So läuft die Umstellung ab

1. Sichern. Dateien und Datenbank vollständig.
2. Extensions erfassen. Für jede Extension den Composer-Paketnamen ermitteln. Eigene Extensions bekommen eine eigene composer.json und kommen in einen lokalen Ordner, meist packages/.
3. Neues Projekt anlegen mit composer.json, TYPO3-Kern und allen Extensions in passenden Versionen.
4. Inhalte übernehmen. Der Ordner fileadmin/ wandert nach public/fileadmin/. Die Site-Konfigurationen liegen unter config/sites/, die Systemeinstellungen ab TYPO3 12 unter config/system/settings.php.
5. Datenbank anbinden und unter „Admin Tools → Maintenance“ die Datenbankstruktur prüfen und die Caches leeren.
6. Auf einer Testumgebung prüfen: Frontend, Backend, Formulare, Suche, Bilder und Weiterleitungen.
7. Live schalten durch Umstellen des Document Root auf den neuen public/-Ordner. Der alte Stand bleibt als Rückfallebene erhalten.

Typische Stolpersteine

• Extensions ohne Composer-Paket. Alte Extensions aus dem TER gibt es teilweise nicht auf Packagist. Dann muss man sie lokal einbinden oder ersetzen.
• Feste Pfade im Code. Eigene Extensions und TypoScript verweisen manchmal fest auf typo3conf/ext/. Das muss auf EXT:-Pfade umgestellt werden.
• Dateien außerhalb von fileadmin. Bilder oder PDFs, die irgendwo anders im Webroot liegen, werden beim Umzug gerne vergessen.
• Kein SSH beim Hoster. Dann wird lokal gebaut und das fertige Projekt hochgeladen. Das geht, ist aber umständlicher. Manchmal ist ein Hosterwechsel die bessere Wahl.

Zusammen mit dem Update erledigen

Wer ohnehin von TYPO3 10, 11 oder 12 auf eine aktuelle Version wechseln muss, sollte die Composer-Umstellung im selben Zug erledigen. Alle Extensions müssen dabei sowieso geprüft und aktualisiert werden. Zum Ablauf und den Kosten eines Updates siehe TYPO3-Update: Kosten und Ablauf, zur Lage bei Version 12 TYPO3 12: Support beendet.

Professionelle Hilfe

Ich stelle TYPO3-Seiten auf Composer um, meist im Rahmen eines Updates auf TYPO3 14 LTS, und übergebe danach eine dokumentierte, versionierte Installation. Mehr unter TYPO3-Update und auf der Übersichtsseite TYPO3-Freelancer.