DDEV ist ein Open-Source-Tool, mit dem sich in Minuten lokale PHP-Entwicklungsumgebungen einrichten lassen.
DDEV erstellt eine config.yaml
, die alle Einstellungen für dein Projekt enthält. Diese kann mit GIT versioniert werden und unterstützt so kollaboratives Arbeiten in Teams oder mit Freelancern.
Um DDEV nutzen zu können, muss Docker auf deinem System installiert sein. Falls das noch nicht der Fall ist, kannst du dir die DDEV Dokumentation für mehr Informationen zur Installation dieser Programme durchlesen.
DDEV ist für alle Plattformen verfügbar, für die Installation deiner Plattform schau bitte in der DDEV Dokumentation nach.
Die Contao Demo Webseite wird für die aktuell unterstützten Contao-Versionen gepflegt und kann optional installiert werden. Über den Contao Manager kannst du dazu, bei einer Erstinstalltion, einfach diese Option auswählen.
Öffne die Konsole deiner Wahl, erstelle das gewünschte Verzeichnis und wechsle danach in ebendieses. Der Verzeichnisname spiegelt den späteren Projekt Hostnamen. Du kannst dies jedoch zusätzlich konfigurieren.
mkdir contao && cd contao
DDEV-Konfiguration anlegen mit:
ddev config --project-type=php --docroot=public --webserver-type=apache-fpm --php-version=8.2
Contao 5.3 installieren:
ddev composer create contao/managed-edition:5.3
Nach der Installation müssen die Datenbankzugangsdaten in die .env.local
eingetragen werden. In diesem Zug richten wir auch direkt
Mailpit ein.
ddev dotenv set .env.local --database-url=mysql://db:db@db:3306/db --mailer-dsn=smtp://localhost:1025
Im Anschluss die Datenbank anlegen:
ddev exec contao-console contao:migrate --no-interaction
Backend-User anlegen (Administrator):
ddev exec contao-console contao:user:create --username=admin --name=Administrator --email=admin@example.com --language=de --password=Password123 --admin
Die Contao Administration im Browser aufrufen:
ddev launch contao
Öffne die Konsole deiner Wahl, erstelle das gewünschte Verzeichnis und wechsle danach in ebendieses. Der Verzeichnisname spiegelt den späteren Projekt Hostnamen. Du kannst dies jedoch zusätzlich konfigurieren.
mkdir contao && cd contao
DDEV-Konfiguration anlegen mit:
ddev config --project-type=php --docroot=public --webserver-type=apache-fpm --php-version=8.2
Nach der Installation müssen die Datenbankzugangsdaten in die .env.local
eingetragen werden. In diesem Zug richten wir auch direkt
Mailpit ein.
ddev dotenv set .env.local --database-url=mysql://db:db@db:3306/db --mailer-dsn=smtp://localhost:1025
Den Contao Manager herunterladen, umbenennen (.php) und in das public
Verzeichnis kopieren. Du kannst dazu auch wget
oder curl
nutzen.
ddev start
ddev exec "wget -O public/contao-manager.phar.php https://download.contao.org/contao-manager/stable/contao-manager.phar"
Den Contao Manager aufrufen und den Anweisungen folgen.
ddev launch contao-manager.phar.php
ddev start
startet das Projekt, ddev stop
beendet es. Stelle vorher sicher, dass du in den Projektordner gewechselt hast.
ddev poweroff
kann aus jedem Verzeichnis heraus alle gestarteten Projekte/Container stoppen.
Mit ddev ssh
wechselst du in die Shell des Containers und kannst auf der Konsole arbeiten. Die ddev
Binary steht im Container nicht zur Verfügung, also erst mit exit
auf die Host-Konsole wechseln.
ddev describe
gibt eine Übersicht der Services, die im Projekt zur Verfügung stehen und wie du sie erreichst.
ddev xdebug on
startet XDebug. Informationen zum IDE-Setup
Falls du als Windows Anwender die »Git Bash« als Konsole benutzt, kann es, abhängig von deiner »Git für Windows« Konfiguration, notwendig sein das Kommando winpty
voran zu stellen (z. B.: winpty ddev ssh
).
Mit DDEV können zusätzliche PHP-Konfigurationen für ein Projekt bereitgestellt werden. Du kannst eine beliebige Anzahl von .ini
Dateien im Verzeichnis .ddev/php/
hinzufügen. Änderungen erfordern einen Neustart mit ddev restart
. Weitere Informationen in der DDEV-Dokumentation.
Eine Beispieldatei in .ddev/php/my-php.ini
könnte wie folgt aussehen:
[PHP]
memory_limit = -1
DDEV bietet auch Services als Addon.
ddev get ddev/ddev-adminer && ddev restart
Mit ddev describe
erfährst du, wie du Adminer erreichst.