TYPO3 Tipps & Tricks

Wer eine TYPO3-Website aufsetzen möchte, steht früher oder später vor einer grundlegenden Entscheidung: klassische Legacy-Installation oder Composer-basierte Installation? Beide Varianten führen zu einem funktionsfähigen TYPO3-System. Doch bei Wartung, Updates, Erweiterungen und langfristiger Projektentwicklung gibt es deutliche Unterschiede.

Während die klassische Installation lange Zeit der Standard war, hat sich Composer in der professionellen PHP-Entwicklung längst etabliert. Auch im TYPO3-Umfeld ist Composer heute der bevorzugte Weg für neue Projekte.

Aber bedeutet das automatisch, dass jede bestehende Legacy-Installation umgestellt werden sollte? Und welche Vorteile bietet Composer tatsächlich im Entwicklungsalltag?

Schauen wir uns beide Varianten genauer an.

Was bedeutet Legacy-Installation bei TYPO3?

Bei einer klassischen TYPO3-Installation, häufig auch als Classic Mode oder Legacy-Installation bezeichnet, werden TYPO3 und die benötigten Erweiterungen ohne Composer verwaltet.

Die Installation erfolgt beispielsweise über ein heruntergeladenes TYPO3-Paket. Erweiterungen werden klassisch über den TYPO3 Extension Manager beziehungsweise die entsprechende Backend-Verwaltung eingebunden.

Die Dateien liegen direkt innerhalb der TYPO3-Projektstruktur. Abhängigkeiten und Updates werden nicht zentral über einen PHP-Paketmanager gesteuert.

Vorteile einer Legacy-Installation

Einfacher Einstieg

Gerade bei kleineren Websites oder für Einsteiger kann eine klassische Installation zunächst unkompliziert wirken. TYPO3 wird bereitgestellt, die Datenbank eingerichtet und die Website kann konfiguriert werden.

Weniger Anforderungen an die Entwicklungsumgebung

Composer muss nicht zwingend auf dem Server oder in der lokalen Entwicklungsumgebung vorhanden sein. Auch ein Deployment ohne Composer-Befehle ist grundsätzlich möglich.

Bekannte Arbeitsweise bei älteren Projekten

Viele bestehende TYPO3-Websites wurden über Jahre klassisch betrieben. Wer diese Systeme betreut, kennt die entsprechenden Verzeichnisstrukturen und Update-Prozesse.

Nachteile einer Legacy-Installation

Aufwendigeres Dependency-Management

Sobald mehrere Extensions und PHP-Bibliotheken zum Einsatz kommen, wird die Verwaltung der Abhängigkeiten schwieriger. Versionskonflikte müssen unter Umständen manuell gelöst werden.

Weniger reproduzierbare Installationen

Die exakt gleiche Installation auf einem lokalen Entwicklungsserver, einer Staging-Umgebung und dem Produktivserver bereitzustellen, erfordert mehr Disziplin und zusätzliche Prozesse.

Kompliziertere Update-Prozesse

TYPO3-Core und Extensions müssen hinsichtlich ihrer Kompatibilität geprüft und aktualisiert werden. Bei größeren Projekten kann das schnell zeitaufwendig werden.

Eingeschränkte Integration in moderne Entwicklungsworkflows

Automatisierte Deployments, Continuous Integration und reproduzierbare Builds lassen sich zwar auch ohne Composer umsetzen, benötigen jedoch meist zusätzliche Lösungen.

Mein Eindruck: Für bestehende, überschaubare TYPO3-Projekte kann eine klassische Installation weiterhin funktionieren. Bei komplexeren Anwendungen stößt dieser Ansatz allerdings schneller an organisatorische Grenzen.

Was ist eine Composer-basierte TYPO3-Installation?

Composer ist ein Paketmanager für PHP. Er verwaltet die benötigten Softwarepakete, deren Versionen und Abhängigkeiten zentral.

Bei einer Composer-basierten TYPO3-Installation werden sowohl der TYPO3-Core als auch Extensions und weitere PHP-Bibliotheken über Composer eingebunden.

Die wichtigsten Dateien dafür sind:

• composer.json: Definiert die benötigten Pakete und Versionsanforderungen.
• composer.lock: Hält die konkret aufgelösten Paketversionen fest.
• vendor/: Enthält die installierten Composer-Pakete und den Autoloader.

Ein neues TYPO3-Projekt lässt sich beispielsweise mit folgendem Befehl erstellen:

composer create-project typo3/cms-base-distribution mein-projekt

Weitere Erweiterungen können anschließend gezielt hinzugefügt werden:

composer require vendor/extension-name

Composer prüft dabei die definierten Abhängigkeiten und ermittelt eine kompatible Kombination der benötigten Pakete.

Vorteile einer Composer-basierten Installation

1. Zentrale Verwaltung aller Abhängigkeiten

Der größte Vorteil liegt für mich in der zentralen Paketverwaltung.

TYPO3-Core, Extensions und zusätzliche PHP-Bibliotheken werden über einen gemeinsamen Mechanismus verwaltet.

Composer berücksichtigt dabei die Versionsanforderungen der Pakete und erkennt viele Abhängigkeitskonflikte bereits vor der Installation.

Das reduziert den manuellen Aufwand und macht komplexe Projekte besser beherrschbar.

2. Reproduzierbare Entwicklungsumgebungen

Ein wichtiger Vorteil im professionellen Entwicklungsalltag ist die composer.lock.

Sie dokumentiert die konkret verwendeten Paketversionen. Dadurch können Entwickler und Deployment-Systeme dieselben Abhängigkeiten installieren.

Mit

composer install

werden die im Lockfile festgelegten Versionen installiert, soweit sie mit der jeweiligen Plattform kompatibel sind.

Das erleichtert die Zusammenarbeit im Team und sorgt für mehr Konsistenz zwischen Entwicklungs-, Test- und Produktivumgebung.

3. Einfachere Updates

Updates lassen sich über Composer gezielt vorbereiten und durchführen.

Beispielsweise:

composer update "typo3/*" --with-all-dependencies

Composer berücksichtigt dabei die definierten Versionsbeschränkungen und Abhängigkeiten.

Wichtig ist allerdings: Composer automatisiert die Paketverwaltung, nicht das gesamte TYPO3-Upgrade.

Datenbankanpassungen, Upgrade-Wizards, Breaking Changes und individuelle Extensions müssen weiterhin geprüft werden.

4. Bessere Integration in Git und Deployment-Prozesse

In einem Composer-Projekt müssen die installierten Abhängigkeiten normalerweise nicht vollständig im Git-Repository gespeichert werden.

Stattdessen werden unter anderem composer.json und composer.lock versioniert.

Das ermöglicht schlankere Repositories und kontrollierte Deployments.

Besonders bei Projekten mit mehreren Entwicklern, Staging-Systemen oder automatisierten Deployment-Prozessen ist das ein erheblicher Vorteil.

5. Zugriff auf das PHP-Ökosystem

Composer beschränkt sich nicht auf TYPO3-Extensions.

Auch zahlreiche zusätzliche PHP-Bibliotheken können eingebunden werden, beispielsweise für PDF-Erzeugung, API-Kommunikation, Datenverarbeitung oder andere individuelle Funktionen.

Gerade bei maßgeschneiderten TYPO3-Extensions eröffnet das viele Möglichkeiten.

6. Zukunftssichere Projektstruktur

Composer-basierte Installationen entsprechen den etablierten Standards moderner PHP-Projekte.

Sie erleichtern die Wartung, die Zusammenarbeit mit anderen Entwicklern und die Integration in zeitgemäße Entwicklungswerkzeuge.

Für neue, langfristig angelegte TYPO3-Projekte ist das aus meiner Sicht ein entscheidendes Argument.

Nachteile einer Composer-basierten Installation

So viele Vorteile Composer bietet: Ganz ohne Nachteile ist auch dieser Ansatz nicht.

1. Höhere Einstiegshürde

Wer bislang ausschließlich mit klassischen TYPO3-Installationen gearbeitet hat, muss sich zunächst mit Composer, Paketversionen, Abhängigkeiten und der Kommandozeile vertraut machen.

Auch die Unterschiede zwischen composer install, composer update und composer require sollten verstanden werden.

2. Abhängigkeitskonflikte können komplex werden

Composer erkennt Versionskonflikte zuverlässig, löst aber nicht automatisch jeden Konflikt.

Gerade bei älteren Extensions, eingeschränkten PHP-Versionen oder größeren TYPO3-Upgrades können widersprüchliche Anforderungen auftreten.

Dann ist es notwendig, die Paketabhängigkeiten genauer zu analysieren und gegebenenfalls Extensions zu aktualisieren oder zu ersetzen.

3. Anforderungen an Hosting und Deployment

Für einen reibungslosen Composer-Workflow sollte eine passende Entwicklungs- oder Build-Umgebung vorhanden sein.

Nicht jeder einfache Webhosting-Tarif bietet dafür ideale Voraussetzungen.

Allerdings muss Composer nicht zwingend auf dem Produktivserver ausgeführt werden. Die Abhängigkeiten können auch in einer separaten Build-Umgebung installiert und anschließend bereitgestellt werden.

4. Mehr Verantwortung bei der Paketverwaltung

Composer bietet viel Kontrolle – diese muss aber auch sinnvoll genutzt werden.

Unbedachte Updates, zu weit gefasste Versionsanforderungen oder ein nicht sauber gepflegtes Lockfile können zu unerwarteten Problemen führen.

Ein strukturierter Update- und Deployment-Prozess bleibt deshalb unverzichtbar.

TYPO3 Legacy vs. Composer im direkten Vergleich

Sollte man bestehende Legacy-Projekte auf Composer umstellen?

Nicht unbedingt sofort.

Eine bestehende TYPO3-Website, die stabil läuft und regelmäßig gepflegt wird, muss nicht allein deshalb umgestellt werden, weil Composer heute der bevorzugte Installationsweg ist.

Eine Migration sollte vielmehr im Zusammenhang mit dem Zustand und der weiteren Entwicklung des Projekts betrachtet werden.

Eine Umstellung ist besonders sinnvoll, wenn:

• ein größeres TYPO3-Upgrade geplant ist,
• mehrere individuelle oder externe Extensions eingesetzt werden,
• die Website langfristig weiterentwickelt werden soll,
• mehrere Entwickler am Projekt arbeiten,
• automatisierte Deployment-Prozesse eingeführt werden sollen.

Bei einer kleinen Website ohne besondere technische Anforderungen kann es dagegen wirtschaftlicher sein, die bestehende Installation zunächst weiterzubetreiben.

Wichtig ist, die Migration sorgfältig vorzubereiten. Individuelle Extensions, Drittanbieterpakete, Dateipfade und die bestehende Deployment-Struktur müssen berücksichtigt werden.

Eine Composer-Migration ist keine reine Umstellung der Verzeichnisstruktur, sondern sollte als eigenständige technische Aufgabe geplant und getestet werden.

Mein Fazit: Composer ist für neue TYPO3-Projekte die bessere Wahl

Für mich ist die Entscheidung bei neuen TYPO3-Projekten eindeutig: Ich setze auf Composer.

Nicht, weil eine klassische Installation grundsätzlich schlecht wäre, sondern weil Composer im Entwicklungsalltag entscheidende Vorteile bietet.

Die zentrale Verwaltung von Abhängigkeiten, reproduzierbare Installationen, kontrollierte Updates und die bessere Integration in moderne Entwicklungsprozesse machen Projekte langfristig wartbarer und flexibler.

Gerade bei individuellen TYPO3-Lösungen mit eigenen Extensions, Schnittstellen und zusätzlichen PHP-Bibliotheken möchte ich auf diese Möglichkeiten nicht verzichten.

Legacy-Installationen haben weiterhin ihre Berechtigung, insbesondere bei bestehenden Websites. Hier sollte immer individuell geprüft werden, ob und wann eine Umstellung sinnvoll ist.

Meine Empfehlung lautet deshalb:

Neue TYPO3-Projekte grundsätzlich Composer-basiert aufsetzen. Bestehende Legacy-Projekte bei größeren Updates oder Weiterentwicklungen auf eine mögliche Migration prüfen.

Denn am Ende zählt nicht, welcher Installationsweg auf den ersten Blick einfacher erscheint, sondern welcher Ansatz die Website langfristig zuverlässig, wartbar und wirtschaftlich betreibbar macht.

Sie betreuen eine klassische TYPO3-Installation oder planen ein größeres TYPO3-Upgrade? 
Ich unterstütze Sie bei der technischen Bewertung, der Umstellung auf Composer und der Weiterentwicklung Ihrer TYPO3-Website.