Die professionelle Methode für moderne TYPO3-Projekte
In der TYPO3-Welt hat sich Composer in den letzten Jahren als Standard für professionelle Installationen etabliert. Die klassische ZIP-Variante ist zwar nach wie vor verfügbar, aber wer TYPO3 in einem produktiven, wartbaren und skalierbaren Umfeld einsetzen möchte, kommt um Composer nicht herum.
In diesem Blogbeitrag erfährst du, wie du TYPO3 via Composer installierst, warum diese Methode so mächtig ist – und wie du dein Projekt von Anfang an zukunftssicher aufsetzt.
Was ist Composer?
Composer ist ein Dependency-Manager für PHP. Er ermöglicht das Verwalten, Aktualisieren und Installieren von PHP-Paketen (z. B. TYPO3, Erweiterungen oder Bibliotheken) auf Basis einer zentralen Datei: der composer.json.
Statt Dateien manuell zu kopieren, installiert Composer genau die Versionen, die du brauchst – inklusive aller Abhängigkeiten.
Warum Composer für TYPO3?
| Vorteil | Bedeutung | | ------------------------- | ------------------------------------------------------- | | 🧩 Modularität | TYPO3 und Extensions als sauber verwaltete Pakete | | 🔁 Updates per Befehl | Einfaches composer update statt ZIP-Datei ersetzen | | 🔐 Sicherheit | Klar definierte Versionen und Lock-Dateien | | 🧪 Reproduzierbarkeit | Gleiche Umgebung auf Dev-, Staging- und Produktivsystem | | 🧬 Erweiterbarkeit | Integration in Git, CI/CD, Docker, DDEV u. v. m. |
Voraussetzungen
- PHP 8.1 oder höher (je nach TYPO3-Version)
- Composer installiert:
→ https://getcomposer.org/download/
- Webserver (Apache/Nginx) oder DDEV/Docker
- MySQL/MariaDB/PostgreSQL-Datenbank
Schritt-für-Schritt: TYPO3 mit Composer installieren
1. Neues Projekt erstellen
``bash composer create-project typo3/cms-base-distribution meinprojekt ^12 cd meinprojekt ``
Erklärung:
- Erstellt ein neues TYPO3-Projekt mit Basis-Distribution
- Installiert automatisch die aktuelle LTS-Version
2. Lokalen Webserver starten (optional)
Variante A: PHP-Built-in-Server (nur für Entwicklung)
``bash php -S 127.0.0.1:8080 -t public ``
Dann im Browser: http://localhost:8080/typo3/install.php
Variante B: Apache/Nginx
- Konfiguriere die Domain so, dass sie auf das Verzeichnis
public/zeigt.
3. Installer starten
Rufe im Browser install.php auf, z. B.:
`` http://localhost:8080/typo3/install.php ``
Dort:
- Datenbank konfigurieren
- Admin-Benutzer anlegen
- System überprüfen
- Backend aktivieren
Projektstruktur bei Composer
``bash meinprojekt/ ├── public/ → öffentlicher Webroot (enthält index.php) ├── config/ → Konfigurationsdateien (z. B. sites/) ├── var/ → temporäre Dateien, Cache etc. ├── composer.json → Paketdefinitionen ├── composer.lock → exakte Versionen ├── vendor/ → heruntergeladene PHP-Bibliotheken ``
Extensions via Composer installieren
Beispiel: news-Extension installieren
``bash composer require georgringer/news ``
Danach im TYPO3-Backend aktivieren.
Updates & Wartung
TYPO3 & Extensions aktualisieren:
``bash composer update ``
Optional: nur einzelne Pakete:
``bash composer update typo3/cms-core ``
Änderungen am Dateisystem (z. B. neue Dateien):
``bash vendor/bin/typo3cms install:fixfolderstructure ``
Bonus: TYPO3-Projekt mit Git verwalten
Empfohlene Versionierung:
composer.json&composer.lockconfig/,public/typo3conf/AdditionalConfiguration.php- eigene Extensions & Templates
Nicht versionieren:
vendor/,var/,public/fileadmin/,public/typo3temp/
Perfekt kombinierbar mit:
- 🐳 Docker / DDEV
- 🔁 CI/CD mit GitHub Actions, GitLab CI
- 🧪 Testing & Code Quality Tools
- 🧬 Environment Management (z. B. .env-Dateien)
Fazit
Die TYPO3-Installation via Composer ist der professionelle Weg, um saubere, wartbare und zukunftssichere Projekte aufzubauen. Ob für kleine Sites oder große Enterprise-Portale – Composer ermöglicht dir präzise Kontrolle über deine TYPO3-Umgebung und ist Grundlage jeder modernen TYPO3-Entwicklung.
Wenn du TYPO3 ernsthaft einsetzen möchtest, solltest du Composer nicht nur kennen, sondern aktiv einsetzen.
Weiterführende Links
- TYPO3 Composer Packages: https://packagist.org/search/?q=typo3
- Offizielle Composer-Doku: https://getcomposer.org/doc/
- TYPO3 Composer Guide: https://docs.typo3.org/m/typo3/guide-installation
