DDEV Spickzettel

Alle Befehle im Projektordner ausfuehren (z. B. im PhpStorm-Terminal, Alt+F12).

Projekt steuern

Befehl	Wirkung
ddev start	Projekt starten (einmal pro Sitzung / nach Neustart)
ddev stop	Projekt stoppen
ddev restart	Neu starten - noetig nach Aenderungen in .ddev/
ddev poweroff	Alle DDEV-Projekte stoppen
ddev list	Alle Projekte und ihren Status anzeigen
ddev describe	URLs, Ports und Zugangsdaten anzeigen
ddev launch	Seite im Browser oeffnen

Konfiguration

Befehl / Datei	Wirkung
ddev config	Projekt einrichten oder Einstellungen aendern
ddev config --php-version=8.5	PHP-Version aendern (danach ddev restart)
.ddev/config.yaml	Projekt-Konfiguration, z. B. host_db_port: "33060" fuer festen DB-Port
.ddev/php/custom.ini	Eigene PHP-Einstellungen, z. B. short_open_tag = On (nur pro Projekt, keine globale php.ini)

Im Container arbeiten

Befehl	Wirkung
ddev ssh	Shell im Web-Container oeffnen
ddev exec <befehl>	Einzelnen Befehl im Container ausfuehren
ddev composer install	Composer im Container
ddev php spark migrate	PHP / CodeIgniter-Spark im Container
ddev php -l datei.php	PHP-Syntax einer Datei pruefen
ddev logs -f	Webserver-Logs live anzeigen

Datenbank

Befehl	Wirkung
ddev import-db --file=dump.sql.gz	Dump importieren - ersetzt die bestehende DB komplett
ddev export-db --file=backup.sql.gz	Datenbank exportieren
ddev mysql	MySQL-Konsole oeffnen
ddev mysql -e "SHOW TABLES;"	Tabellen anzeigen
ddev mysql -e "DROP DATABASE db; CREATE DATABASE db;"	Datenbank leeren
ddev snapshot	Schnelle Sicherung der DB
ddev snapshot restore	Sicherung wiederherstellen

Zugangsdaten: Host db (im Code, nicht localhost) - Datenbank/User/Passwort jeweils db - Port 3306
Von Windows/PhpStorm aus: Host 127.0.0.1, Port laut ddev describe bzw. host_db_port.

Sonstiges

Befehl	Wirkung
ddev add-on get ddev/ddev-phpmyadmin	phpMyAdmin installieren, Aufruf mit ddev phpmyadmin
ddev xdebug on / off	Xdebug ein-/ausschalten
ddev delete	Projekt aus DDEV entfernen (Dateien bleiben, DB wird geloescht)
ddev help	Uebersicht aller Befehle

Neues Projekt einrichten (Kurzablauf)

1. ddev config --project-name=NAME --docroot=public --project-type=php --php-version=8.5
2. Bei Bedarf .ddev/php/custom.ini anlegen (z. B. short_open_tag)
3. ddev start
4. ddev composer install
5. ddev import-db --file=dump.sql.gz
6. In .env DB-Zugang (Host db) und app.baseURL = 'https://NAME.ddev.site/' eintragen
7. ddev launch

PhpStorm

• DDEV starten/stoppen: Statusleiste unten oder Tools -> DDEV
• Automatisch starten: Run -> Edit Configurations -> + -> Shell Script mit ddev start, dann unter Settings -> Tools -> Startup Tasks hinzufuegen
• Datenbank: View -> Tool Windows -> Database - Aenderungen mit Strg+Enter speichern
• Docker muss laufen - Docker Desktop: Settings -> General -> Start when you sign in