Wie installiert man TYPO3 mit Composer: Schritt-für-Schritt-Anleitung

Warum TYPO3 mit Composer installieren?

Die Installation von TYPO3 mit Composer ist der bevorzugte Ansatz für professionelle Projekte, da es die Abhängigkeitsverwaltung vereinfacht, die Konsistenz bei Bereitstellungen verbessert und TYPO3 Core- sowie Extension-Updates leichter kontrollierbar macht.

Bei einer herkömmlichen TYPO3-Installation müssen Teams das Core-Paket herunterladen, Dateien manuell hochladen, Extensions separat installieren und bei jeder Änderung die Kompatibilität überprüfen. Dies wird schwierig, wenn mehrere Extensions von unterschiedlichen TYPO3-, PHP- oder Bibliotheksversionen abhängig sind.

Häufige Probleme sind:

• Extensions finden, die mit der installierten TYPO3-Version kompatibel sind
• PHP- und Paketanforderungen manuell prüfen
• Konfligierende Abhängigkeiten verwalten
• Dieselbe Einrichtung in lokalen, Staging- und Produktionsumgebungen reproduzieren
• TYPO3 Core und mehrere Extensions aktualisieren, ohne das Projekt zu beschädigen

Composer löst diese Probleme, indem es die in composer.json definierten Abhängigkeiten liest, kompatible Paketversionen auswählt und die genaue Installation in composer.lock speichert.

Wichtige Vorteile der Verwendung von Composer mit TYPO3

Die Verwendung von Composer ermöglicht es TYPO3-Teams:

• TYPO3 Core und Extensions über die Kommandozeile zu installieren
• Paketabhängigkeiten automatisch aufzulösen
• Konsistente Entwicklungs-, Staging- und Produktionsumgebungen zu verwalten
• Abhängigkeitsänderungen über Git nachzuverfolgen
• Extensions sicherer zu aktualisieren oder zu entfernen
• Paketänderungen mithilfe von composer.lock zurückzurollen
• Sicherheitsprüfungen, Tests und CI/CD-Workflows zu integrieren
• Schnellere und zuverlässigere Bereitstellungsprozesse zu erstellen

Einfach ausgedrückt ersetzt Composer die manuelle Paketverwaltung durch einen wiederholbaren und kontrollierten Workflow. Dadurch ist es besonders wertvoll für TYPO3 Agenturen, Entwicklungsteams und Organisationen, die langfristige oder geschäftskritische Websites verwalten.

Welche TYPO3-Version sollten Sie installieren?

Für ein neues TYPO3-Projekt installieren Sie TYPO3 v14 LTS. Es ist die aktuelle stabile Version und die offiziell empfohlene Version für neue Projekte. TYPO3 v13 LTS wird weiterhin für bestehende Websites unterstützt, die noch nicht für ein Upgrade bereit sind, während TYPO3 v12 jetzt Extended Long Term Support benötigt, um weiterhin Sicherheits- und Compliance-Updates zu erhalten.

TYPO3 v14 und v13 Systemanforderungen

Sowohl TYPO3 v14 als auch v13 unterstützen:

• PHP 8.2, 8.3, 8.4 und 8.5
• MariaDB 10.4.3 oder höher
• MySQL 8.0.17 oder höher
• PostgreSQL 10 oder höher
• SQLite 3.8.3 oder höher

Stellen Sie vor der Installation sicher, dass Ihre PHP-CLI-Version, die PHP-Version des Webservers und die Datenbank die Anforderungen der ausgewählten TYPO3-Version erfüllen.

Wichtig: Befehle, die für TYPO3 7.6, TYPO3 8.1, PHP 5.3, dev-master oder typo3/cms:^7.6 geschrieben wurden, sind veraltet. Sie sollten nicht für eine moderne TYPO3 Composer-Installation verwendet werden.

Was benötigen Sie vor der Installation von TYPO3?

Bevor Sie TYPO3 mit Composer installieren, stellen Sie sicher, dass Ihr Server oder Ihre lokale Entwicklungsumgebung die technischen Anforderungen erfüllt. Die meisten Installationsprobleme entstehen durch inkompatible PHP-Versionen, fehlende Erweiterungen, falsche Berechtigungen oder einen Webserver, der auf das falsche Verzeichnis zeigt.

Anforderungen für die TYPO3 Composer-Installation

Stellen Sie sicher, dass Ihre Umgebung Folgendes enthält:

• Linux, macOS oder Windows
• Kommandozeilen- oder SSH-Zugriff
• Composer 2.x
• Eine PHP-Version, die von Ihrer TYPO3-Version unterstützt wird
• Erforderliche PHP-Erweiterungen
• Eine unterstützte MySQL-, MariaDB-, PostgreSQL- oder SQLite-Datenbank
• Gültige Datenbankzugangsdaten
• Berechtigung zum Erstellen von Verzeichnissen und symbolischen Links
• Zugriff zum Ändern des Dokumentenstamms der Website
• Ein leeres Projektverzeichnis

PHP und Composer prüfen

Führen Sie diese Befehle aus, bevor Sie das TYPO3-Projekt erstellen:

Sie bestätigen die aktive PHP-Version, die Composer-Installation und mögliche Konfigurationsprobleme, die die Abhängigkeitsverwaltung beeinflussen könnten.

Befehls-Pfade prüfen

Bei Managed Hosting kann sich die im Terminal verwendete PHP-Version von der Version unterscheiden, die von der Website verwendet wird. Prüfen Sie die aktiven ausführbaren Pfade mit:

which php
which composer

Unter Windows verwenden Sie:

where php
where composer

Die PHP-Version der Kommandozeile und die PHP-Version des Webservers müssen beide die Anforderungen der ausgewählten TYPO3-Version erfüllen.

Webroot bestätigen

Ihre Hosting-Umgebung muss es ermöglichen, dass die Domain oder der virtuelle Host auf das public/-Verzeichnis des TYPO3-Projekts zeigt. Dadurch bleiben Konfigurationen, Abhängigkeiten und Anwendungsdateien außerhalb des öffentlich zugänglichen Webroots.

Prüfung vor der Installation: Beginnen Sie die TYPO3 Composer-Installation erst, wenn PHP, Composer, Datenbankzugriff, Verzeichnisberechtigungen und der public/-Dokumentenstamm bestätigt wurden.

Wie installiert man Composer?

Bevor Sie Composer installieren, prüfen Sie, ob es bereits auf Ihrem lokalen Rechner oder Server verfügbar ist:

composer --version

Wenn der Befehl eine Composer-2.x-Version zurückgibt, können Sie direkt mit der TYPO3-Installation fortfahren.

Wichtig: composer install installiert Composer selbst nicht. Es installiert die Abhängigkeiten, die in der vorhandenen composer.json- oder composer.lock-Datei eines Projekts definiert sind.

Composer global installieren

Eine globale Composer-Installation ermöglicht es Ihnen, Composer aus jedem Projektverzeichnis heraus auszuführen:

composer install

Unter Windows ist die einfachste Methode die Verwendung des offiziellen Composer-Installers, der Composer konfiguriert und zum System-PATH hinzufügt. Unter Linux und macOS folgen Sie den aktuellen Kommandozeilen-Installationsanweisungen von Composer. Vermeiden Sie das Kopieren von Installersignaturen aus alten Tutorials, da sich der Prüf-Hash ändert, sobald ein neuer Installer veröffentlicht wird.

Composer lokal verwenden

Wenn Composer als composer.phar im aktuellen Verzeichnis gespeichert ist, führen Sie Befehle über PHP aus:

php composer.phar install

Die globale und lokale Methode führen dieselben Composer-Aufgaben aus. Nur der Befehlspräfix ändert sich.

Nach der Installation überprüfen Sie, ob Composer korrekt funktioniert:

composer --version
composer diagnose

Wenn der Server mehrere PHP-Versionen besitzt, prüfen Sie, welche PHP- und Composer-Programme aktiv sind:

which php
which composer

Unter Windows verwenden Sie:

where php
where composer

Einige Managed-Hosting-Umgebungen benötigen vollständige Pfade zu den ausführbaren Dateien, beispielsweise:

/path/to/php /path/to/composer create-project \
  "typo3/cms-base-distribution:^14" my-typo3-project

Composer ist der Dependency-Manager von PHP. Packagist ist das standardmäßige öffentliche Repository, aus dem Composer viele Pakete bezieht. Es handelt sich um verbundene Dienste, aber nicht um dasselbe Werkzeug.

Wie installiert man TYPO3 v14 mit Composer?

Die Installation von TYPO3 v14 mit Composer umfasst vier Hauptschritte: das Erstellen des Projekts, die Konfiguration des öffentlichen Dokumentenstamms, das Abschließen der TYPO3-Einrichtung und die Überprüfung der Installation.

Schritt 1: TYPO3-Projekt erstellen

Führen Sie den folgenden Befehl aus dem übergeordneten Verzeichnis aus, in dem der neue Projektordner erstellt werden soll:

composer create-project \
 "typo3/cms-base-distribution:^14" \
 my-typo3-project

Wechseln Sie in das neue Projektverzeichnis:

cd my-typo3-project

Das Zielverzeichnis muss leer sein. Versteckte Dateien, die von einer IDE, einer Git-Initialisierung oder dem Betriebssystem erstellt wurden, können verhindern, dass composer create-project erfolgreich ausgeführt wird.

Composer lädt den TYPO3 Core, erforderliche Systempakete und deren kompatible Abhängigkeiten herunter. Außerdem erstellt es die anfängliche Projektstruktur einschließlich composer.json, composer.lock, public/, packages/, config/, var/ und vendor/.

Um stattdessen ein TYPO3 v13 LTS-Projekt zu erstellen, ändern Sie die Versionsanforderung:

composer create-project \
 "typo3/cms-base-distribution:^13" \
 my-typo3-project

Schritt 2: Webserver auf public/ ausrichten

Konfigurieren Sie den Apache-, Nginx-, IIS- oder Hosting-Dokumentenstamm so, dass er auf Folgendes zeigt:

/path/to/my-typo3-project/public

Ältere TYPO3 Composer-Projekte können ein Verzeichnis mit dem Namen web verwenden, aber die aktuelle Base Distribution verwendet public/.

Diese Struktur verhindert, dass Konfigurationsdateien, Abhängigkeiten und Anwendungscode direkt über den Browser zugänglich sind. Nur Dateien, die für den öffentlichen Webzugriff vorgesehen sind, sollten über public/ bereitgestellt werden.

Schritt 3: TYPO3-Installation abschließen

Die empfohlene Kommandozeilen-Methode ist:

./vendor/bin/typo3 setup

Die geführte Einrichtung fragt nach:

• Datenbankverbindungsdetails
• Administrator-Benutzername und Passwort
• Projekt- oder Site-Name
• Grundlegender Site-Konfiguration

Alternativ können Sie den browserbasierten Installationsassistenten starten, indem Sie eine leere FIRST_INSTALL-Datei erstellen:

touch public/FIRST_INSTALL

Unter Windows PowerShell verwenden Sie:

New-Item public/FIRST_INSTALL -ItemType File

Öffnen Sie anschließend die Projekt-URL in einem Browser. TYPO3 überprüft die PHP-Umgebung, Dateiberechtigungen, Datenbankverbindung und erforderlichen Extensions, bevor die Installation abgeschlossen wird.

Schritt 4: TYPO3-Installation überprüfen

Nach der Einrichtung bestätigen Sie, dass:

• Das Frontend ohne Installationsfehler geöffnet wird
• Das Backend unter /typo3/ verfügbar ist
• Das Administratorkonto funktioniert
• Die Domain auf das public/-Verzeichnis zeigt
• composer.json und composer.lock vorhanden sind
• Der Umgebungs-Scan keine kritischen Probleme meldet
• Die Datenbankverbindung funktioniert
• Projektdateien in der Versionskontrolle gespeichert sind
• composer.lock in Git committed wurde

Eine erfolgreiche Composer-basierte Installation bietet dem Projekt eine wiederholbare Grundlage. Dieselben gesperrten Paketversionen können anschließend über Entwicklungs-, Staging- und Produktionsumgebungen hinweg mit folgendem Befehl installiert werden:

composer install

Wie installiert man TYPO3 mit DDEV?

DDEV ist eine der einfachsten Möglichkeiten, TYPO3 lokal zu installieren. Es erstellt eine konsistente Docker-basierte Umgebung mit Webserver, PHP und Datenbank, sodass Entwickler die einzelnen Dienste nicht manuell konfigurieren müssen.

DDEV ist ausschließlich für lokale TYPO3-Entwicklung vorgesehen. Produktionswebsites sollten über einen separaten Hosting- und Bereitstellungsworkflow veröffentlicht werden.

Voraussetzungen

Installieren Sie vor dem Start:

• Docker
• DDEV
• Git
• Ein Terminal oder eine Kommandozeilenanwendung

Composer muss nicht separat auf dem Host-Rechner installiert werden, da DDEV Composer innerhalb seines Web-Containers ausführen kann.

Schritt 1: Projektverzeichnis erstellen

Erstellen Sie einen leeren Ordner und wechseln Sie hinein:

mkdir my-typo3-project
cd my-typo3-project

Schritt 2: DDEV für TYPO3 konfigurieren

Konfigurieren Sie das Projekt als TYPO3-Installation mit public/ als Dokumentenstamm:

ddev config \
 --project-type=typo3 \
 --docroot=public \
 --php-version=8.4

Die Konfiguration wird in .ddev/config.yaml gespeichert, wodurch jeder Entwickler dieselbe lokale Umgebung starten kann.

Starten Sie die Container:

ddev start

Schritt 3: TYPO3 v14 mit Composer installieren

Erstellen Sie das TYPO3 v14-Projekt innerhalb des aktuellen Verzeichnisses:

ddev composer create-project “typo3/cms-base-distribution:^14”

DDEV führt Composer innerhalb des Containers aus und installiert den TYPO3 Core, erforderliche Pakete sowie die Standard-Projektstruktur.

Schritt 4: Optionales Camino Theme hinzufügen

Für eine sofort sichtbare Demonstrationswebsite installieren Sie das Camino Theme:

ddev composer require typo3/theme-camino

Camino ist optional. Es bietet einen schnellen Ausgangspunkt für das Frontend und kann später durch ein benutzerdefiniertes TYPO3 Site Package ersetzt werden.

Schritt 5: TYPO3-Einrichtung abschließen

Führen Sie den TYPO3-Setup-Befehl mit den DDEV-Datenbankzugangsdaten aus:

ddev typo3 setup \
 --server-type=other \
 --driver=mysqli \
 --host=db \
 --port=3306 \
 --dbname=db \
 --username=db \
 --password=db \
 --admin-username=admin \
 --admin-user-password="Replace-With-A-Strong-Password" \
 --admin-email=admin@example.com \
 --project-name="My TYPO3 Website" \
 --force

Ersetzen Sie das Beispiel-Administratorkennwort und die E-Mail-Adresse, bevor Sie den Befehl ausführen. DDEV stellt für die lokale Entwicklung automatisch die Datenbank mit dem Namen db sowie den Benutzernamen und das Passwort db bereit.

Der Setup-Befehl erstellt die Datenbankverbindung, das Administratorkonto und die grundlegende TYPO3-Konfiguration.

Schritt 6: TYPO3-Website öffnen

Starten Sie die Camino-Demoseite:

ddev launch /camino

Öffnen Sie das TYPO3-Backend:

ddev launch /typo3/

Melden Sie sich mit den während der Einrichtung erstellten Administrator-Zugangsdaten an.

DDEV-Installation überprüfen

Prüfen Sie, dass:

• DDEV ohne Container-Fehler startet
• TYPO3 im Browser geöffnet wird
• Der Backend-Login funktioniert
• Der Dokumentenstamm auf public/ gesetzt ist
• composer.json und composer.lock vorhanden sind
• Die Datenbankverbindung funktioniert

Zeigen Sie die Projekt-URL, Datenbankdetails und den Containerstatus mit folgendem Befehl an:

ddev describe

Um die lokale Umgebung zu stoppen, ohne das Projekt zu löschen, führen Sie aus:

ddev stop

Starten Sie sie später erneut mit:

ddev start

Bestehendes TYPO3-Projekt: Wenn Sie mit einem bestehenden Git-Repository arbeiten, führen Sie ddev composer install anstelle von ddev composer create-project aus. Dadurch werden die exakten Paketversionen installiert, die in der composer.lock-Datei des Projekts gespeichert sind.

Die TYPO3 Composer-Projektstruktur verstehen

Ein Composer-basiertes TYPO3-Projekt trennt öffentliche Dateien, Konfiguration, benutzerdefinierte Pakete und Drittanbieter-Abhängigkeiten.

Committen Sie composer.json und composer.lock in Git. Committen Sie nicht vendor/, da Composer dieses Verzeichnis mit folgendem Befehl wiederherstellen kann:

composer install

Composer, Packagist und TER: Was ist der Unterschied?

• Composer: Installiert, aktualisiert und entfernt PHP-Pakete.
• Packagist: Das standardmäßige öffentliche Paket-Repository von Composer.
• TER: Der Extension-Katalog von TYPO3 zum Finden von Extensions und Überprüfen der Kompatibilität.
• composer.typo3.org: Ein zusätzliches Repository, das hauptsächlich für bestimmte Legacy-Pakete verwendet wird.

Die meisten modernen TYPO3 Extensions werden über Packagist installiert. Fügen Sie composer.typo3.org nur hinzu, wenn die Dokumentation einer Extension dies ausdrücklich erfordert.

Wie installiert man eine TYPO3 Extension mit Composer?

Suchen Sie zuerst die Extension im TYPO3 Extension Repository, auf Packagist oder in der offiziellen Dokumentation und bestätigen Sie den Composer-Paketnamen.

Composer-Paketnamen verwenden dieses Format:

vendor/package-name

Zum Beispiel:

Extension key: extension_builder
Composer package: friendsoftypo3/extension-builder

Die Extension installieren

Um die TYPO3 News Extension zu installieren, führen Sie den folgenden Befehl im Projektstammverzeichnis aus:

composer require georgringer/news

Composer wird:

• Das Paket zu composer.json hinzufügen
• Eine mit dem Projekt kompatible Version auswählen
• Die Abhängigkeiten installieren
• composer.lock aktualisieren

Die offizielle TYPO3-Dokumentation empfiehlt, den Composer-Paketnamen der Extension mit composer require zu verwenden.

Extension-Setup abschließen

Nach der Installation führen Sie aus:

./vendor/bin/typo3 extension:setup

Dadurch werden TYPO3-spezifische Setup-Aufgaben abgeschlossen, einschließlich Änderungen am Datenbankschema und der Paketkonfiguration.

Um eine bestimmte Hauptversion zu installieren, verwenden Sie eine passende Versionsanforderung:

composer require georgringer/news:"^14"

Für die meisten Projekte ist der Befehl ohne Versionsangabe sicherer, da Composer die neueste Version auswählt, die mit der installierten TYPO3-Version kompatibel ist. Das aktuelle News-Paket unterstützt moderne TYPO3-Installationen.

Vermeiden Sie die Verwendung von * als Versionsanforderung, da dadurch ein unkontrollierter Bereich von Versionen zugelassen wird.

Ein Standard-PHP-Paket installieren

Composer kann auch normale PHP-Bibliotheken installieren:

composer require monolog/monolog

Composer stellt das Paket über den Standard-Autoloader des Projekts unter vendor/autoload.php zur Verfügung.

Eine Extension entfernen

Um die News Extension zu entfernen, führen Sie aus:

composer remove georgringer/news
./vendor/bin/typo3 extension:setup

Nach der Installation, Aktualisierung oder Entfernung einer Extension committen Sie die aktualisierten composer.json- und composer.lock-Dateien, damit dieselben Abhängigkeitsversionen über Entwicklungs-, Staging- und Produktionsumgebungen hinweg reproduziert werden können.

Was ist der Unterschied zwischen require, install und update?

Composer-Befehle erfüllen unterschiedliche Zwecke: