WP-CLI-referentie (Pro)

Vereisten

• WP-CLI installed on the server (or SSH session).
• Multisite Migrate plugin active; run commands from the WordPress root (wp must load the site).
• Pro-licentie — every command except help requires Multisite Migrate Pro. Plus and Free licenses cannot use WP-CLI.
• WordPress capability: manage_options (single site) or manage_network (multisite network tasks).

Aan de slag

wp multisite-migrate help
wp multisite-migrate help --topic=restore
wp multisite-migrate backup --help
wp multisite-migrate list

help 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.

Commandoboom

Commando	Doel
backup	Voer een back-uptaak uit (lokaal en optioneel cloudupload)
restore <job-id>	Herstel op dezelfde server of URL-migratie met topologie-opties
import	Archief registreren vanaf schijf, URL of cloud; optioneel geketend herstel
list	Maak een lijst van voltooide back-up- of hersteltaken
status <job-id>	Taakvoortgang, percentage en metagegevens
cancel <job-id>	Een actieve taak annuleren
delete <job-id>	Verwijder het taakrecord en het lokale archief, indien aanwezig
prefetch <job-id>	Download alleen een back-up in de cloud voordat u deze herstelt
manifest <job-id>	Archiefmanifest JSON afdrukken
migration-preview <job-id>	Voorbeeld van URL- en tabeltoewijzing voor migratie
info	Pluginversie, engine en licentieoverzicht
health	PHP-extensies, schijfruimte, opslagpaden
cleanup	Verwijder tijdelijke import- en werkbestanden
prune	Pas het bewaarbeleid toe op oude lokale back-ups
installer	Implementeer het installatieprogramma naast een back-up of download bootstrap PHP
recovery	Noodherstelpunt instellen, starten of opnieuw instellen
list-remote <channel>	Maak een lijst van externe back-ups (gdrive, s3, sftp, dropbox)
staging	Een staging-subsite maken, verwijderen of ernaar pushen
help	Print deze referentie in de terminal

Back-up

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 --incremental

Common flags: --upload, --destination=local|gdrive|s3|sftp|ftp|dropbox, --scope=network|subsite, --profile=full|db|files|media|plugins|themes|custom, --incremental, --quiet.

Voor cloudupload is Plus/Pro-cloudopslag vereist die is geconfigureerd in Cloudopslag. Netwerkbereik is beschikbaar voor netwerkbeheerders op Free+; Netwerktaken voor subsite-admin volgen nog steeds de stoel-/capaciteitsregels.

Herstellen

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 --yes

Topology flags mirror Advanced restore in the admin UI:

• --topology-import=subsite_on_network + --topology-target-url=… — subsite backup onto an existing network
• --topology-import=network_to_subsite + --topology-target-blog-id=… — network backup into a subsite slot
• --prefix-policy=keep_source|remap_wp, --blog-domains=<json>, --passphrase=… for .venc

Long restores show a progress bar. Safety snapshot runs unless --no-safety-snapshot. Use --yes to skip overwrite confirmation.

Importeren

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 --yes

Remote 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.

Taakbeheer

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 42

list supports --format=table|json|csv. Subsite admins on multisite see only their scope unless they have network cap.

Installateur & lege 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=php

Implementeert dezelfde wizard als Importeren → Installatieprogramma openen. --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.

Herstel na een ramp

wp multisite-migrate recovery set --job-id=42
wp multisite-migrate recovery status
wp multisite-migrate recovery launch
wp multisite-migrate recovery reset

Wedstrijden Back-ups → Herstel: in-place overwrite from a pinned full backup with WordPress core. Disable site-wide with define('MM_DISALLOW_RECOVERY', true); in wp-config.php.

Staging

wp multisite-migrate staging create --slug=staging --title="Staging"
wp multisite-migrate staging delete --slug=staging
wp multisite-migrate staging push --job-id=42

Requires Pro CAP_STAGING. Same flows as Staging in the restore guide.

Onderhoud

wp multisite-migrate info
wp multisite-migrate health
wp multisite-migrate cleanup
wp multisite-migrate prune
wp multisite-migrate list-remote gdrive

Licentiemogelijkheden

Na de Pro-poort kunnen individuele opdrachten secundaire mogelijkheden vereisen (hetzelfde als de beheerdersinterface):

Vermogen	CLI-voorbeelden
CAP_CLI	All commands except help — Pro only
CAP_CLOUD	backup --upload, prefetch, list-remote
CAP_REMOTE_IMPORT	import --url, import --from=*
CAP_MULTISITE	Netwerkbrede beheerdersstromen waarvoor de multisite-mogelijkhedenpoort vereist is (zie CLI-help)
CAP_INSTALLER	installer download
CAP_STAGING	staging *

Compare plans

Scenario-recepten

Scenario	Commando's
Subsite → zelfstandige migratie	wp multisite-migrate restore <id> --migration --old-url=… --new-url=… --yes
Subsite → bestaand netwerk	wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --yes
Netwerk → subsiteslot	wp multisite-migrate restore <id> --topology-import=network_to_subsite --topology-target-blog-id=… --yes
Importeren en vervolgens installeren	wp multisite-migrate import /path/backup.zip --restore
Importeren en vervolgens in-plug-in herstellen	wp multisite-migrate import /path/backup.zip --restore --via-worker --yes
Alleen cloud-back-up → herstellen	wp multisite-migrate prefetch <id> then wp multisite-migrate restore <id> --yes
Installatieprogramma implementeren (bridge)	wp multisite-migrate installer <id> --bridge
Herstelpunt voor noodgevallen	wp multisite-migrate recovery set --job-id=<id> then recovery launch

Mondiale vlaggen

• --quiet — suppress progress messages on long jobs
• --porcelain — machine-readable progress lines

Gerelateerde handleidingen

• Backup guide
• Restore guide
• User Manual hub

Veelgestelde vragen over WP-CLI

Voor Shell-automatisering is Pro vereist. Gebruik help op de server voor de live-opdrachtenlijst.

Welke licentie heb ik nodig voor WP-CLI?

Pro. Free en Plus kunnen geen Multisite Migrate WP-CLI-opdrachten uitvoeren (behalve het bekijken van hulp indien beschikbaar).

Waar moet ik wp-opdrachten uitvoeren?

Vanuit de WordPress-root laadt WP-CLI de site. De Multisite Migrate-plug-in moet actief zijn.

Kan ik planningen automatiseren via CLI?

Ja op Pro: back-up-, herstel-, import-, installatie-, herstel- en staging-opdrachten weerspiegelen de beheerdersinterface. Zie het gedeelte met recepten hierboven.

Geldt de geld-terug-garantie van 14-dag als ik alleen WP-CLI gebruik?

Ja. Nieuwe Plus- of Pro-aankopen omvatten een geld-terug-garantie van 14 dagen, ongeacht of u de voorkeur geeft aan de beheerdersinterface of WP-CLI.