Lokale Entwicklungsumgebung mit DDEV und Composer

Eine lokale Entwicklungsumgebung mit DDEV und Composer bietet dir ein konsistentes, reproduzierbares Setup, das sich – unabhängig von deinem Betriebssystem – leicht einrichten und warten lässt. Durch den Einsatz von DDEV nutzt du Docker-Container, um Webserver, Datenbank und alle weiteren Abhängigkeiten isoliert voneinander zu betreiben. So verhinderst du das berüchtigte „It works on my machine“-Problem und stellst sicher, dass deine Anwendung in jeder Umgebung identisch läuft. Composer übernimmt dabei das Management deiner PHP-Pakete: Versionierung, automatische Updates und Abhängigkeitsauflösung geschehen auf Knopfdruck, sodass du dich voll und ganz auf die Entwicklung konzentrieren kannst.

Mit dieser Kombination aus DDEV und Composer profitierst du von schnellen Spin-up-Zeiten, einfacher Skalierung und einer sauberen Trennung zwischen Projekt und Hostsystem. Ob Teamarbeit, Continuous Integration oder Deployment – deine Umgebung bleibt stets stabil und nachvollziehbar. Außerdem lassen sich unterschiedliche PHP-Versionen und Datenbanksysteme im Handumdrehen konfigurieren, was gerade in heterogenen Projektlandschaften ein unschätzbarer Vorteil ist.

1. Projektverzeichnis anlegen

Im ersten Schritt müssen wir ein Verzeichnis für deine Projekt auf dem lokalen System anlegen:

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

2. DDEV initialisieren

Als nächstes wollen wir ein neues DDEV-Projekt initialisieren, worin später unsere lokale Entwicklungsumgebung ausgeführt wird.

ddev config \
  --project-type=typo3 \
  --docroot=public \
  --php-version=8.3 \
  --webserver-type=nginx-fpm \
  --project-name=my-typo3-project

Das erzeugt eine .ddev-Konfiguration mit php_version: "8.3" und richtet den Ordner public/ als Webroot ein. Wenn Du auch ein phpMyAdmin während der Entwicklung benötigst, kannst Du es mit dem folgenden Befehl installieren:

ddev add-on get ddev/ddev-phpmyadmin

Du kannst deine Umgebung nun mit ddev start starten. DDEV lädt die Docker-Container, richtet Web- und Datenbank-Container ein und stellt die Umgebung unter einer lokalen URL bereit (z. B. https://my-typo3-project.ddev.site). Um alle Informationen zu deinem DDEV anzuzeigen, führe einfach den Befehl ddev describe aus.

3. TYPO3 mit Composer installieren

Für die Installation des TYPO3 verwenden wir Composer. Hierfür bietet TYPO3 eine bereits vordefiniertes Packagist Paket mit dem Namen typo3/cms-base-distribution, welches wir mit dem folgenden Befehl installieren:

ddev composer create-project typo3/cms-base-distribution:^13 .

Hinweis:

TYPO3 Version 13 ist aktuell die LTS-Version und unterstützt PHP 8.3.

4. Packages konfigurieren

Damit wir in unserer Umgebung direkt eine Website-Ausgabe haben, installieren wir das Bootstrap-Package von Benjamin Kott:

ddev composer require bk2k/bootstrap-package

Das Paket wird automatisch im /vendor/ Verzeichnis abgelegt und taucht im Extension Manager von TYPO3 auf. Da wir das Paket Fluid-Styled-Content nun nicht mehr brauchen, deinstallieren wir dieses:

ddev composer remove typo3/cms-fluid-styled-content

Damit wir besser mit der Command-Line arbeiten können, installieren wir die TYPO3-Console von Helmut Hummel, welche die Consolen-Befehle für TYPO3 um viele nützliche Befehle erweitert:

ddev composer req helhum/typo3-console

Abschließend fügen wir das Modules-Package hinzu, welche viele nützliche Funktionen rund um Frontend-Benutzer (z.B. Benutzer-Profil, Registrierung, Listen, Detailansicht, Einladungscodes, etc.) bereitstellt

ddev composer req codingms/modules

Zusammengefasst in einem Befehl heißt das:

ddev composer remove typo3/cms-fluid-styled-content \
    && ddev composer require \
    bk2k/bootstrap-package \
    helhum/typo3-console \
    codingms/modules

6. TYPO3-Setup

Um nun mit dem TYPO3 arbeiten zu können, müssen noch einige wenige Schritte ausgeführt werden. Z.B. müssen wir dem TYPO3 beibringen, wo es seine Datenbank findet, die notwendige Datenbank-Struktur erstellen und einen Backend-Administrator erstellen. Das TYPO3-Setup kannst Du mit dem folgenden Befehl starten:

ddev typo3 setup --server-type=other --driver=mysqli --host=db --port=3306 --dbname=db --username=db --password=db

Während der Ausführung stellt Dir das Script die folgenden Fragen:

• Admin username (user will be "system maintainer") -> localadmin
• Admin user and installer password -> Local123!
• Admin user email -> admin(at)localhist(dot)de
• Give your project a name -> New TYPO3 Project
• Admin user email -> admin(at)localhist(dot)de
• Create a basic site? Please enter a URL -> press Enter

Zusätzlich setzen wir eine Default From-Mailadresse, die immer dann als Absende-Adresse verwendet wird, wenn beim Versand keine explizit angegeben wurde:

ddev exec vendor/bin/typo3 configuration:set MAIL/defaultMailFromAddress theo(at)my-typo3-project(dot)de

Jetzt wo Dein TYPO3 eingerichtet ist, kannst Du es mit folgendem Befehl aufrufen:

ddev launch

Dein TYPO3 Version 13 mit PHP 8.3 und dem Bootstrap-Package im DDEV kannst Du auch unter der URLhttps://my-typo3-project.ddev.site/ im Frontend und mit der URLhttps://my-typo3-project.ddev.site/typo3 im Backend aufrufen.

Tip:

Hier kannst Du alle verschickten Mails einsehen: https://my-typo3-project.ddev.site:8026/