WP-CLI
WP-CLI-Referenz (Pro)
Automatisieren Sie Sicherungen, Wiederherstellungen, Importe, Installationsbereitstellung, Notfallwiederherstellung und Staging über die Shell. Vollständige Parität mit der Multisite Migrate-Administrator-Benutzeroberfläche – Pro-Lizenz für jeden Befehl außer Hilfe erforderlich.
Anforderungen
- WP-CLI installed on the server (or SSH session).
- Multisite Migrate plugin active; run commands from the WordPress root (
wpmust load the site). - Pro-Lizenz — every command except
helprequires Multisite Migrate Pro. Plus and Free licenses cannot use WP-CLI. - WordPress capability:
manage_options(single site) ormanage_network(multisite network tasks).
Erste Schritte
wp multisite-migrate help
wp multisite-migrate help --topic=restore
wp multisite-migrate backup --help
wp multisite-migrate listhelp prints a full command tree, capability notes, and copy-paste examples. Use --topic=backup|restore|import|jobs|installer|recovery|staging|caps to filter sections. Per-command flags are documented with native WP-CLI --help.
Befehlsbaum
| Befehl | Zweck |
|---|---|
backup | Führen Sie einen Sicherungsauftrag aus (lokal und optionaler Cloud-Upload). |
restore <job-id> | Wiederherstellung auf demselben Server oder URL-Migration mit Topologieoptionen |
import | Archiv von Festplatte, URL oder Cloud registrieren; optionale verkettete Wiederherstellung |
list | Listen Sie abgeschlossene Sicherungs- oder Wiederherstellungsjobs auf |
status <job-id> | Auftragsfortschritt, Prozent und Metadaten |
cancel <job-id> | Brechen Sie einen laufenden Job ab |
delete <job-id> | Auftragsdatensatz und lokales Archiv löschen, sofern vorhanden |
prefetch <job-id> | Laden Sie vor der Wiederherstellung ein reines Cloud-Backup herunter |
manifest <job-id> | Archivmanifest JSON drucken |
migration-preview <job-id> | Vorschau der URL- und Tabellenzuordnung für die Migration |
info | Plugin-Version, Engine und Lizenzübersicht |
health | PHP-Erweiterungen, Speicherplatz, Speicherpfade |
cleanup | Entfernen Sie temporäre Import- und Worker-Dateien |
prune | Wenden Sie Aufbewahrungsrichtlinien auf alte lokale Sicherungen an |
installer | Stellen Sie das Installationsprogramm neben einem Backup bereit oder laden Sie Bootstrap PHP herunter |
recovery | Disaster-Recovery-Punkt festlegen, starten oder zurücksetzen |
list-remote <channel> | Remote-Backups auflisten (gdrive, s3, sftp, dropbox) |
staging | Erstellen, löschen oder pushen Sie eine Staging-Unterwebsite |
help | Drucken Sie diese Referenz im Terminal aus |
Sicherung
wp multisite-migrate backup
wp multisite-migrate backup --upload --destination=gdrive
wp multisite-migrate backup --scope=network --profile=full
wp multisite-migrate backup --scope=subsite --profile=db --incrementalCommon flags: --upload, --destination=local|gdrive|s3|sftp|ftp|dropbox, --scope=network|subsite, --profile=full|db|files|media|plugins|themes|custom, --incremental, --quiet.
Für den Cloud-Upload ist der in konfigurierte Plus/Pro-Cloud-Speicher erforderlich Cloud-Speicher. Der Netzwerkumfang steht Netzwerkadministratoren auf Free+ zur Verfügung; Subsite-Administrator-Netzwerkjobs unterliegen weiterhin den Platz-/Fähigkeitsregeln.
Wiederherstellen
wp multisite-migrate restore 42 --yes
wp multisite-migrate restore 42 --mode=db --no-safety-snapshot
wp multisite-migrate restore 42 --migration --old-url=https://old.example --new-url=https://new.example --yesTopologie-Flags entsprechen der Multisite-Wiederherstellung in der Admin-Oberfläche:
--topology-import=subsite_on_network+--topology-target-url=…— Subsite-Backup auf ein bestehendes Netzwerk--topology-import=network_to_subsite+--topology-target-blog-id=…— Netzwerk-Backup in einen Subsite-Slot--prefix-policy=keep_source|remap_wp,--blog-domains=<json>,--passphrase=…für.venc- Gemeinsame Benutzer zusammenführen (bei den beiden Netzwerk-Landing-Modi standardmäßig an):
--user-merge/--no-user-merge,--uid-fields=_customer_user,_other_meta,--reset-imported-passwords,--send-password-reset-email
wp multisite-migrate restore 42 --topology-import=subsite_on_network --topology-target-url=https://network.example/site/ --user-merge --uid-fields=_customer_user --yesLange Restores zeigen einen Fortschrittsbalken. Das Safety-Snapshot läuft, sofern nicht --no-safety-snapshot gesetzt ist. Mit --yes überspringen Sie die Überschreiben-Bestätigung.
Importieren
wp multisite-migrate import /var/backups/site.zip
wp multisite-migrate import --url=https://cdn.example/backup.zip
wp multisite-migrate import --from=gdrive --remote-id=FILE_ID --name=site.zip
wp multisite-migrate import /path/archive.zip --restore --via-worker --yesRemote URL and cloud channels require Pro (CAP_REMOTE_IMPORT). Chain --restore to start restore immediately; add --via-worker for in-plugin restore instead of installer deploy.
Jobmanagement
wp multisite-migrate list --type=backup --format=table --limit=50
wp multisite-migrate status 42
wp multisite-migrate cancel 42
wp multisite-migrate delete 42
wp multisite-migrate manifest 42
wp multisite-migrate migration-preview 42list supports --format=table|json|csv. Subsite admins on multisite see only their scope unless they have network cap.
Installateur & leerer Server
wp multisite-migrate installer 42
wp multisite-migrate installer 42 --bridge
wp multisite-migrate installer Download --type=php
wp multisite-migrate installer Download 42 --type=phpStellt denselben Assistenten bereit wie Importieren → Installationsprogramm öffnen. --bridge uses wp-admin MU-plugin proxy when archives are protected. Download writes bootstrap PHP beside your shell (Pro CAP_INSTALLER).
See also Empty-Server-Migration.
Notfallwiederherstellung
wp multisite-migrate recovery set --job-id=42
wp multisite-migrate recovery status
wp multisite-migrate recovery launch
wp multisite-migrate recovery resetStreichhölzer Backups → Wiederherstellung: in-place overwrite from a pinned full backup with WordPress core. Disable site-wide with define('MM_DISALLOW_RECOVERY', true); in wp-config.php.
Inszenierung
wp multisite-migrate staging create --slug=staging --title="Staging"
wp multisite-migrate staging delete --slug=staging
wp multisite-migrate staging push --job-id=42Requires Pro CAP_STAGING. Same flows as Staging in der Restore-Anleitung.
Wartung
wp multisite-migrate info
wp multisite-migrate health
wp multisite-migrate cleanup
wp multisite-migrate prune
wp multisite-migrate list-remote gdriveLizenzfunktionen
Nach dem Pro-Gate erfordern einzelne Befehle möglicherweise sekundäre Funktionen (wie die Admin-Benutzeroberfläche):
| Fähigkeit | CLI-Beispiele |
|---|---|
CAP_CLI | All commands except help — Pro only |
CAP_CLOUD | backup --upload, prefetch, list-remote |
CAP_REMOTE_IMPORT | import --url, import --from=* |
CAP_MULTISITE | Netzwerkweite Admin-Flows, die das Multisite Capability Gate erfordern (siehe CLI-Hilfe) |
CAP_INSTALLER | installer Download |
CAP_STAGING | staging * |
CAP_NETWORK_SPLIT | split-network, split-status, split-cancel, split-resume, restore --topology-import=extract_site_standalone |
Szenario-Rezepte
| Szenario | Befehle |
|---|---|
| Unterwebsite → Standalone-Migration | wp multisite-migrate restore <id> --migration --old-url=… --new-url=… --yes |
| Geteiltes Netzwerk → Archive pro Standort | wp multisite-migrate split-network --yes then split-status — see Netzwerk-Split-Anleitung |
| Setzen Sie die fehlgeschlagene Teilung fort | wp multisite-migrate split-resume --yes then split-status |
| Netzwerkarchiv → ein eigenständiger Standort | wp multisite-migrate restore <id> --migration --topology-import=extract_site_standalone --source-blog-id=N --old-url=… --new-url=… --yes then migration-verify |
| Überprüfen Sie übrig gebliebene URLs | wp multisite-migrate migration-verify --old-url=… |
| Bestätigtes Suchen/Ersetzen | wp multisite-migrate search-replace --old=… --new=… --yes |
| Unterwebsite → bestehendes Netzwerk (Benutzer zusammenführen) | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --yes |
| Netzwerk → Subsite-Slot (Benutzer zusammenführen) | wp multisite-migrate restore <id> --topology-import=network_to_subsite --topology-target-blog-id=… --user-merge --yes |
| Netzwerkimport ohne Benutzerzusammenführung | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --no-user-merge --yes |
| Benutzer zusammenführen + Passwörter zurücksetzen | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --reset-imported-passwords --send-password-reset-email --yes |
| Importieren und dann Installationsprogramm | wp multisite-migrate import /path/backup.zip --restore |
| Importieren und dann im Plugin wiederherstellen | wp multisite-migrate import /path/backup.zip --restore --via-worker --yes |
| Nur Cloud-Sicherung → Wiederherstellung | wp multisite-migrate prefetch <id> then wp multisite-migrate restore <id> --yes |
| Installationsprogramm bereitstellen (Brücke) | wp multisite-migrate installer <id> --bridge |
| Disaster-Recovery-Punkt | wp multisite-migrate recovery set --job-id=<id> then recovery launch |
Globale Flaggen
--quiet— suppress progress messages on long jobs--porcelain— machine-readable progress lines
Verwandte Leitfäden
WP-CLI-FAQ
Für die Shell-Automatisierung ist Pro erforderlich. Verwenden Sie die Hilfe auf dem Server für die Live-Befehlsliste.
Welche Lizenz benötige ich für WP-CLI?
Pro. Free und Plus können keine Multisite Migrate WP-CLI-Befehle ausführen (außer beim Anzeigen der Hilfe, sofern verfügbar).
Wo soll ich wp-Befehle ausführen?
Aus dem WordPress-Stammverzeichnis lädt WP-CLI die Site. Das Multisite Migrate-Plugin muss aktiv sein.
Kann ich Zeitpläne über CLI automatisieren?
Ja bei Pro – Backup-, Wiederherstellungs-, Import-, Installations-, Wiederherstellungs- und Staging-Befehle spiegeln die Admin-Benutzeroberfläche wider. Siehe den Abschnitt „Rezepte“ oben.
Wie füge ich Benutzer zusammen, wenn ich sie über WP-CLI in einem Netzwerk wiederherstelle?
Verwenden Sie --topology-import=subsite_on_network oder network_to_subsite. Die Zusammenführung freigegebener Benutzer ist standardmäßig aktiviert. Übergeben Sie --no-user-merge zum Überspringen oder --uid-fields und --reset-imported-passwords nach Bedarf. Siehe den Abschnitt zur Wiederherstellung und die Rezepte oben.
Gilt die 14-Tages-Geld-zurück-Garantie, wenn ich nur WP-CLI verwende?
Ja. Neue Plus- oder Pro-Käufe beinhalten eine 14-Tage-Geld-zurück-Garantie, unabhängig davon, ob Sie Admin-UI oder WP-CLI bevorzugen.