WP Staging CLI kann Docker-basierte WordPress-Umgebungen für lokale Entwicklung und Tests erstellen und verwalten. Diese Anleitung behandelt das Hinzufügen, Auflisten, Löschen und Verwalten von WordPress-Websites.
Was du erhältst
Jede Docker-Website enthält:
- PHP-FPM mit der gewählten PHP-Version
- Nginx-Webserver mit HTTPS
- MariaDB-Datenbank
- Mailpit für E-Mail-Tests
- Automatische SSL-Zertifikate über mkcert
- Hosts-Datei-Konfiguration für lokale Domains
Voraussetzungen
- Docker 20.10.0 oder höher
- Docker Compose 2.19.0 oder höher
- Mindestens 2 CPU-Kerne und 4 GB RAM
Eine neue Website hinzufügen
Erstelle eine neue WordPress-Website mit einer benutzerdefinierten lokalen Domain:
wpstaging add https://mysite.localOder ohne Protokoll:
wpstaging add mysite.localBrauchst du eine WordPress-Multisite?
wpstaging add mysite.local --multisiteNachdem die Website erstellt wurde, kannst du sie unter https://mysite.local aufrufen.
Eine Website aus einer vorhandenen Backup-Datei hinzufügen
Erstelle eine neue Website und stelle sie in einem Schritt aus einer WP Staging Backup-Datei wieder her:
wpstaging add mysite.local --from=backup.wpstgOder von einer Remote-URL:
wpstaging add mysite.local --from=https://example.com/backup.wpstgWordPress Multisite:
wpstaging add mysite.local --multisite --from=BACKUP_URLDies ist der empfohlene Weg, um eine lokale Kopie deiner Produktionswebsite zu erstellen. Es kümmert sich um alles: Docker-Einrichtung, Backup-Extraktion, Datenbankimport und URL-Ersetzung.
Website-Konfiguration anpassen
PHP-Version
Gib die PHP-Version an (Standard ist 8.1):
wpstaging add mysite.local --php=8.2Die verfügbaren PHP-Versionen hängen von den unterstützten Docker-Images ab.
WordPress-Version
Installiere eine bestimmte WordPress-Version (Standard ist die neueste):
wpstaging add mysite.local --wp=6.4.2Benutzerdefinierte Ports
Ändere die Standardports, wenn sie mit anderen Diensten in Konflikt stehen:
wpstaging add mysite.local \
--http-port=8080 \
--https-port=8443 \
--db-port=3307Container-IP-Adresse
Standardmäßig verwenden Websites IP-Adressen im Bereich 127.3.2.x. Du kannst eine benutzerdefinierte IP angeben:
wpstaging add mysite.local --container-ip=127.0.0.1Umgebungspfad
Ändere, wo Docker-Umgebungen gespeichert werden (Standard: ~/wpstaging):
wpstaging add mysite.local --env-path=/custom/pathAlle Add-Befehl-Flags
| Flag | Standard | Beschreibung |
|---|---|---|
--php | 8.1 | PHP-Version |
--wp | latest | WordPress-Version |
--from | – | Backup-Dateipfad oder URL zur Wiederherstellung |
--env-path | ~/wpstaging | Path to store Docker environments |
--container-ip | 127.3.2.1 | Container-IP-Adresse |
--http-port | 80 | Nginx HTTP port |
--https-port | 443 | Nginx HTTPS port |
--db-port | 3306 | MariaDB port |
--db-root | 123456 | MariaDB root password |
--mailpit-http-port | 8025 | Mailpit web interface port |
--disable-mailpit | false | Disable Mailpit container |
WordPress-Konfigurations-Flags
| Flag | Standard | Beschreibung |
|---|---|---|
--db-name | auto | WordPress-Datenbankname |
--db-user | auto | WordPress-Datenbankbenutzer |
--db-pass | auto | WordPress-Datenbank-Passwort |
--db-prefix | wp_ | WordPress table prefix |
--db-host | localhost | WordPress database hostname |
--db-ssl | false | Enable SSL for WordPress database connection |
--admin-user | admin | WordPress-Admin-Benutzername |
--admin-pass | admin | WordPress-Admin-Passwort |
--admin-email | admin@dev.null | WordPress-Admin-E-Mail |
--secure-credentials | false | Generate random secure credentials |
--multisite | false | Enable WordPress Multisite |
Websites auflisten
Zeige alle WordPress-Websites in deiner Docker-Umgebung an:
wpstaging listBeispielausgabe:
HOSTNAME STATUS PHP IP
mysite.local running 8.1 127.3.2.1
dev.local stopped 8.2 127.3.2.2
test.local running 8.0 127.3.2.3Details für bestimmte Websites anzeigen
Erhalte detaillierte Informationen über eine oder mehrere Websites:
wpstaging list mysite.localOder mehrere Websites:
wpstaging list site1.local site2.localWebsites löschen
Lösche eine bestimmte Website:
wpstaging del mysite.localLösche mehrere Websites:
wpstaging del site1.local site2.localLösche alle Websites (mit Bestätigung):
wpstaging delWarnung: Das Löschen einer Website entfernt alle Dateien, die Datenbank und die Konfiguration. Dies kann nicht rückgängig gemacht werden.
Websites aktivieren/deaktivieren
Deaktiviere eine Website, ohne sie zu löschen:
wpstaging disable mysite.localAktiviere eine deaktivierte Website wieder:
wpstaging enable mysite.localDeaktivierte Websites behalten ihre Daten, aber ihre Container werden nicht gestartet.
Eine Website zurücksetzen
Setze eine Website auf eine frische WordPress-Installation zurück:
wpstaging reset mysite.localDies entfernt alle WordPress-Inhalte und installiert WordPress neu, während die Docker-Konfiguration erhalten bleibt.
Reset with Different WordPress Version
Gib eine andere WordPress-Version beim Zurücksetzen an:
wpstaging reset mysite.local --wp=6.5Reset and Restore from Backup
Setze die Website zurück und stelle sie in einem Schritt aus einem WP Staging Backup wieder her:
wpstaging reset mysite.local --from=backup.wpstg
wpstaging reset mysite.local --from=https://example.com/backup.wpstgSichere Zugangsdaten
Für bessere Sicherheit, besonders in gemeinsam genutzten Umgebungen, verwende zufällige Zugangsdaten:
wpstaging add mysite.local --secure-credentialsDies generiert zufällige Passwörter für:
- MariaDB-Root-Benutzer
- WordPress-Datenbankbenutzer
- WordPress-Admin-Benutzer
Die generierten Zugangsdaten werden nach der Erstellung der Website angezeigt.
WordPress Multisite
Erstelle eine WordPress-Multisite-Installation:
wpstaging add mynetwork.local --multisitemacOS-Hinweise
macOS-Benutzer: Automatische IP-Alias-Bindung ist standardmäßig für nahtlose Multi-Site-Setups über den Loopback-IP-Bereich 127.3.2.1 – 127.3.2.254 aktiviert. Dies erfordert sudo und du wirst zur Passworteingabe aufgefordert.
Tipp: Richte passwortloses sudo für wpstaging ein, um wiederholte Passwortabfragen zu vermeiden. Siehe die FAQ für Anweisungen.
Nächste Schritte
- Control Docker Containers – Container starten, stoppen und verwalten
- Docker Configuration – Erweiterte Konfigurationsoptionen
- Create a Local Copy of WordPress Site – Vollständige Anleitung