Konfiguration und Umgebung

WP Staging CLI generiert Docker-Konfigurationsdateien automatisch, wenn du Websites erstellst. Diese Anleitung behandelt erweiterte Konfigurationsoptionen und die manuelle Dateierstellung.

Konfigurationsdateien

Wenn du eine Website erstellst, generiert WP Staging CLI diese Dateien in ~/wpstaging/sites/<hostname>/:

• docker-compose.yml – Haupt-Docker-Compose-Konfiguration
• .env – Umgebungsvariablen
• nginx/ – Nginx-Konfiguration und SSL-Zertifikate
• php/ – PHP-FPM-Konfiguration
• mariadb/ – MariaDB-Konfiguration und Daten

Hosts-Datei aktualisieren

Füge Einträge in der Hosts-Datei deines Systems für lokale Domain-Auflösung hinzu oder aktualisiere sie:

wpstaging update-hosts-file

Oder verwende den Kurzbefehl:

wpstaging uhf

Dieser Befehl:

• Liest alle konfigurierten Websites
• Fügt Einträge in /etc/hosts (Linux/macOS) oder C:\Windows\System32\drivers\etc\hosts (Windows) hinzu
• Ordnet jeden Hostnamen seiner konfigurierten IP-Adresse zu

Compose-Datei generieren

Generiere die docker-compose.yml-Datei für eine bestimmte Website neu:

wpstaging generate-compose-file mysite.local

Oder verwende den Kurzbefehl:

wpstaging gcf mysite.local

Verwende dies, wenn du Folgendes tun musst:

• Die Compose-Datei auf Standardwerte zurücksetzen
• Nach manuellen Konfigurationsänderungen aktualisieren
• Docker-Probleme beheben

Docker-Dateien generieren

Generiere alle Docker-Konfigurationsdateien für eine Website neu:

wpstaging generate-docker-file mysite.local

Oder verwende den Kurzbefehl:

wpstaging gdf mysite.local

Dies generiert neu:

• docker-compose.yml
• Nginx-Konfiguration
• PHP-FPM-Konfiguration
• Umgebungsdatei

SSL-Zertifikatsverwaltung

WP Staging CLI verwendet mkcert, um lokal vertrauenswürdige SSL-Zertifikate zu generieren.

Zertifikat neu installieren

Bei Zertifikatproblemen generiere das SSL-Zertifikat für eine Website neu:

wpstaging reinstall-cert mysite.local

Zertifizierungsstelle neu installieren

Wenn Zertifikate von deinem Browser nicht als vertrauenswürdig eingestuft werden, installiere die mkcert-CA in deinem System-Truststore neu:

wpstaging reinstall-cert mysite.local --reinstall-ca

Website-Konfiguration anzeigen

Zeige die Umgebungsvariablen und die Konfiguration für eine Website an:

wpstaging compose-info mysite.local

Dies zeigt die analysierten docker-compose.yml-Einstellungen einschließlich:

• Container-Namen und Images
• Port-Zuordnungen
• Volume-Mounts
• Umgebungsvariablen

Benutzerdefinierter Umgebungspfad

Standardmäßig werden alle Docker-Umgebungen in ~/wpstaging gespeichert. Du kannst einen benutzerdefinierten Pfad angeben:

wpstaging add mysite.local --env-path=/custom/docker/path

Verwende dann denselben Pfad für alle nachfolgenden Befehle:

wpstaging start --env-path=/custom/docker/path
wpstaging list --env-path=/custom/docker/path

Benutzerdefinierter Compose-Dateipfad

Gib einen benutzerdefinierten Speicherort für die docker-compose.yml-Datei an:

wpstaging add mysite.local --compose-file=/custom/path/docker-compose.yml

Port-Konfiguration

Wenn Standardports mit anderen Diensten in Konflikt stehen, passe sie beim Erstellen von Websites an:

wpstaging add mysite.local \
  --http-port=8080 \
  --https-port=8443 \
  --db-port=3307 \
  --mailpit-http-port=8026

IP-Adress-Konfiguration

Standardmäßig verwenden Websites IP-Adressen im Bereich 127.3.2.x (Loopback-Adressen). Dies ermöglicht es, mehrere Websites gleichzeitig auf denselben Ports (80/443) zu betreiben.

wpstaging add mysite.local --container-ip=127.3.2.5

macOS-IP-Alias

Unter macOS erstellt die CLI automatisch IP-Aliase für Adressen im Bereich 127.3.2.x. Dies erfordert sudo-Zugriff.

Übersicht der Konfigurationsbefehle

Verzeichnisstruktur

Die Standard-Umgebungsverzeichnisstruktur:

~/wpstaging/
├── sites/
│   └── mysite.local/
│       ├── docker-compose.yml
│       ├── .env
│       ├── www/                    # WordPress files
│       ├── nginx/
│       │   ├── nginx.conf
│       │   └── ssl/
│       │       ├── mysite.local.crt
│       │       └── mysite.local.key
│       ├── php/
│       │   └── php.ini
│       └── mariadb/
│           └── data/               # Database files
└── shared/
    └── mkcert/                     # CA certificates

Nächste Schritte

• Manage Docker WordPress Sites – Websites erstellen und verwalten
• Control Docker Containers – Container starten, stoppen und aufrufen