TYPO3 Composer: vom Classic Mode zur Composer-Installation

Nein, nicht allein wegen TYPO3 14. TYPO3 14 schreibt Composer als Installationsart nicht vor. Dennoch spricht vieles dafür: Composer verwaltet Core, Extensions und Abhängigkeiten an einer Stelle und reproduzierbar. Updates und Deployments werden nachvollziehbarer, weil sich jeder Stand eindeutig festhalten lässt. Ob sich der Aufwand für Ihr Projekt lohnt, hängt vor allem von der Zahl und dem Zustand Ihrer Extensions ab. Eine Pflicht zur Umstellung ergibt sich aus TYPO3 14 selbst nicht.

Der Unterschied liegt darin, wie TYPO3 samt Extensions und Abhängigkeiten ins System kommt und verwaltet wird. Im Composer Mode verwaltet Composer Core, Extensions und PHP-Bibliotheken. Es prüft die Abhängigkeiten, bevor etwas installiert wird. Die Projektstruktur besteht aus composer.json, vendor/ und public/ als Document Root. Im Classic Mode kommt der Core als Archiv oder Symlink, Extensions werden per Extension Manager oder Upload eingespielt. Die Verzeichnisse typo3/ und index.php liegen direkt im Webroot. Einen Abgleich der Abhängigkeiten gibt es nicht, Konflikte zeigen sich erst im laufenden Betrieb.

TYPO3 14 verlangt für jede Extension eine gültige composer.json. Das gilt auch für das Sitepackage und für eigene Extensions. Die Datei ext_emconf.php ist dagegen deprecated. Fehlt die composer.json bei einer Extension, muss sie nachgerüstet werden. Das erhöht bei der Composer-Umstellung den Aufwand je Paket. Prüfen Sie deshalb vorab, welche Ihrer Pakete bereits eine composer.json mitbringen und bei welchen sie noch fehlt.

Der Umstieg auf Composer lohnt sich vor allem, weil Updates nachvollziehbar werden. Jede Versionsänderung erscheint im Git-Diff und kann vor dem Livegang im Review kontrolliert werden. Das Update ist einfacher: Ein Befehl ersetzt die Dateikopie, und auf dem Zielsystem werden die Pakete einfach installiert. Außerdem laufen Core, Extensions und PHP-Bibliotheken in einem Werkzeug und einer composer.json zusammen, statt über Archive und Uploads verteilt zu sein. Das spart Handarbeit und reduziert Fehler beim Einspielen neuer Versionen.

Sichern Sie zuerst Dateien und Datenbank, arbeiten Sie in einer Testumgebung und nutzen Sie Git. Führen Sie Updates nie direkt auf dem Produktivsystem aus.

• Innerhalb einer Hauptversion (z. B. 14.3.6 → 14.3.7): composer update "typo3/cms-*" -W aktualisiert alle Core-Pakete in einem Lauf.
• Neue Hauptversion: Setzen Sie die Constraints der TYPO3-Pakete auf ^14.3 und führen Sie composer require aus.
• PHP unverändert lassen: Klären Sie die PHP-Version vorab und testen Sie, erst dann folgt TYPO3.

Danach leeren Sie mit vendor/bin/typo3 cache:flush die Caches, starten mit vendor/bin/typo3 upgrade:run die Upgrade-Wizards und testen Frontend, Backend und Login.

Meldet Composer, dass die Anforderungen nicht auflösbar sind, findet es keine Versionskombination, die alle Constraints der composer.json erfüllt. Die Fehlermeldung nennt die blockierenden Pakete. Meist fehlt einer Extension die Freigabe für TYPO3 14, oder ihr Constraint ist zu eng. So gehen Sie vor: Mit composer why-not typo3/cms-core:^14.3 sehen Sie, welche Pakete die Zielversion blockieren. Mit composer why vendor/paket sehen Sie, wer ein Paket benötigt. Hängen Sie außerdem eine höhere Version des betroffenen Pakets an den composer require-Befehl an, z. B. helhum/typo3-console:^8.3 statt ^8.2.

Wenn vendor/ vom gesperrten Stand abweicht, etwa nach einem abgebrochenen Composer-Lauf oder manuellen Änderungen im Ordner, bauen Sie es neu auf. Löschen Sie das Verzeichnis mit rm -rf vendor/ und installieren Sie mit composer install alles frisch aus dem gesperrten Stand. Bereits durchgeführte Datenbank-Schritte bleiben dabei unberührt. Anschließend leeren Sie die Caches und führen vendor/bin/typo3 extension:setup aus, das fehlende Tabellen und Spalten anlegt. Prüfen Sie zum Schluss Frontend und Backend.

Stellen Sie zuerst Backup (Dateien und SQL-Export), Testumgebung und Git bereit. Dann gehen Sie so vor: Legen Sie ein neues Zielverzeichnis an und führen Sie composer create-project typo3/cms-base-distribution aus. Ergänzen Sie Core und Extensions per composer require vendor/paket:version; lokale Pakete wie das Sitepackage tragen Sie als Repository in der composer.json ein. Mit composer install bauen Sie vendor/ und public/ auf. Übernehmen Sie die Site-Konfiguration nach config/sites, die Systemeinstellungen nach config/system/settings.php sowie fileadmin und Datenbank. Stellen Sie den Document Root auf public/ und prüfen Sie Frontend und Backend. Erst nach erfolgreichem Test räumen Sie die Alt-Installation auf.

Die Umstellung auf Composer kostet je nach Projektgröße einen bis mehrere Personentage. Den Rahmen setzen vor allem die Zahl und der Zustand Ihrer Extensions sowie die Server-Umgebung. Länger dauert es in diesen Fällen: Viele Extensions haben keine composer.json, sie muss nachgerüstet werden. Das Sitepackage oder eigene Extensions sind nicht an Composer angebunden. Lokale Anpassungen liegen direkt im Extension-Ordner und müssen sauber übertragen werden. Die Server-Umgebung muss erst angepasst werden. Erfassen Sie daher vorab alle Extensions samt Versionen.

Der Preis richtet sich nach dem Aufwand, den Zahl und Zustand der Extensions, das Sitepackage und die Server-Umgebung verursachen. Wird die Umstellung als fester Bestandteil des Updates auf TYPO3 14 LTS von der IllusionFACTORY® übernommen, gelten Aktionspreise je Ausgangsversion ab 1.200 € zzgl. MwSt. Der Endpreis steht nach individueller Prüfung von Extensions und Sitepackage fest. Zusätzlich teurer wird es, wenn Extensions ohne Packagist-Paket nur als Pfad-Repository vorliegen oder lokale Anpassungen im Extension-Ordner gesichert und übertragen werden müssen.

Ja, Extensions aus dem TYPO3 Extension Repository (TER) lassen sich weiter nutzen. Im Composer Mode installieren Sie sie jedoch nicht mehr per Extension Manager oder Archiv-Upload, sondern mit composer require vendor/paket:version. Die Pakete stammen in der Regel aus Packagist. Prüfen Sie je Extension: Gibt es ein Packagist-Paket oder nur ein Pfad-Repository? Ist die Extension für TYPO3 14 freigegeben? Liegen lokale Anpassungen im Extension-Ordner? Diese sichern Sie vor dem Löschen. Gibt es keine passende Version, prüfen Sie TER, Packagist und das Code-Repository des Autors oder suchen eine Alternative.

Ja. Das Repository für TYPO3 ELTS (Extended Long Term Support) ist nur per Composer erreichbar. Eine Installation im Classic Mode kann es nicht nutzen. ELTS liefert Sicherheitsupdates, wenn die kostenlose Pflege einer Version endet.

Besonders relevant ist das für TYPO3 12.4:

• Der kostenlose Support endete am 30.04.2026.
• ELTS läuft bis 30.04.2029, mit Partnerjahr bis 30.04.2030.
• Ohne ELTS bleiben Installationen von den am 09.06.2026 veröffentlichten 14 Advisories ungepatcht, darunter 5 mit Schweregrad „High“.

Wer TYPO3 12 weiterbetreiben will, braucht daher eine Installation mit Composer. Stellen Sie im Classic Mode zuerst auf Composer um.

Composer macht Deployments reproduzierbar. Die composer.lock hält fest, welche Version von Core, Extensions und Bibliotheken installiert ist. Liegt sie im Git-Repository, bringt composer install Test- und Live-System auf denselben Stand. Jede Versionsänderung erscheint im Git-Diff und lässt sich im Review prüfen, bevor sie live geht. Das Deployment besteht darin, den Code aus Git auszuliefern und auf dem Zielsystem die Pakete zu installieren. Die Pakete müssen nicht mehr einzeln hochgeladen werden.

Ja, beides läuft in einem Projekt und einem Auftrag, mit einem Ansprechpartner. Wir arbeiten dabei in klarer Reihenfolge: Zuerst wird die Installation auf Composer umgestellt und getestet, danach folgt das Update auf TYPO3 14.3 LTS. So lassen sich Fehler der Umstellung von Fehlern des Updates trennen. Tritt nach dem Update ein Problem auf, liegt es nicht mehr an der Installationsart.

Wichtig sind:

• vollständiges Backup aus Dateien und SQL-Export
• Testumgebung und Git für nachvollziehbare Änderungen
• Prüfung der Extensions auf composer.json und Freigabe für v14

Die IllusionFACTORY® ist TYPO3 Gold Member und übernimmt die Umstellung auf Composer als festen Bestandteil des Updates auf TYPO3 14 LTS. Wir begleiten Sie von der Bestandsaufnahme bis zum Go-Live, sodass Sie nicht selbst zwischen Composer, Extensions und Server vermitteln müssen. Dazu gehören die Bestandsaufnahme von Extensions, Sitepackage und Server-Umgebung, die Migration auf Composer sowie das Update auf TYPO3 14.3 LTS mit Tests und Go-Live. Sie haben dabei einen Ansprechpartner für den gesamten Ablauf.