WP-CLI
WP-CLI-referentie (Pro)
Automatiseer back-ups, herstel, import, installatie van het installatieprogramma, noodherstel en fasering vanuit de shell. Volledige pariteit met de Multisite Migrate-beheerinterface: Pro-licentie vereist voor elke opdracht behalve hulp.
Vereisten
- WP-CLI installed on the server (or SSH session).
- Multisite Migrate plugin active; run commands from the WordPress root (
wpmust load the site). - Pro-licentie — 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).
Aan de slag
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.
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 --incrementalCommon 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 --yesTopologieflags spiegelen Multisite-restore in de beheerinterface:
--topology-import=subsite_on_network+--topology-target-url=…— subsite-backup op een bestaand netwerk--topology-import=network_to_subsite+--topology-target-blog-id=…— netwerkbackup in een subsite-slot--prefix-policy=keep_source|remap_wp,--blog-domains=<json>,--passphrase=…voor.venc- Gedeelde gebruikers samenvoegen (standaard aan voor de twee netwerk-landingsmodi):
--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 hersteljobs tonen een voortgangsbalk. De safety-snapshot draait tenzij --no-safety-snapshot. Gebruik --yes om de overschrijfbevestiging over te slaan.
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 --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.
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 42list 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=phpImplementeert 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-migratie.
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 resetWedstrijden 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=42Requires Pro CAP_STAGING. Same flows as Staging in de restore-gids.
Onderhoud
wp multisite-migrate info
wp multisite-migrate health
wp multisite-migrate cleanup
wp multisite-migrate prune
wp multisite-migrate list-remote gdriveLicentiemogelijkheden
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 * |
CAP_NETWORK_SPLIT | split-network, split-status, split-cancel, split-resume, restore --topology-import=extract_site_standalone |
Scenario-recepten
| Scenario | Commando's |
|---|---|
| Subsite → zelfstandige migratie | wp multisite-migrate restore <id> --migration --old-url=… --new-url=… --yes |
| Gesplitst netwerk → archieven per site | wp multisite-migrate split-network --yes then split-status — see netwerksplit-gids |
| Hervat de mislukte splitsing | wp multisite-migrate split-resume --yes then split-status |
| Netwerkarchief → één standalone site | wp multisite-migrate restore <id> --migration --topology-import=extract_site_standalone --source-blog-id=N --old-url=… --new-url=… --yes then migration-verify |
| Controleer overgebleven URL's | wp multisite-migrate migration-verify --old-url=… |
| Bevestigd zoeken-vervangen | wp multisite-migrate search-replace --old=… --new=… --yes |
| Subsite → bestaand netwerk (gebruikers samenvoegen) | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --yes |
| Netwerk → subsiteslot (gebruikers samenvoegen) | wp multisite-migrate restore <id> --topology-import=network_to_subsite --topology-target-blog-id=… --user-merge --yes |
| Netwerkimport zonder gebruikerssamenvoeging | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --no-user-merge --yes |
| Gebruikers samenvoegen + wachtwoorden opnieuw instellen | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --reset-imported-passwords --send-password-reset-email --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
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.
Hoe voeg ik gebruikers samen bij het herstellen naar een netwerk via WP-CLI?
Gebruik --topology-import=subsite_on_network of network_to_subsite. Het samenvoegen van gedeelde gebruikers is standaard ingeschakeld; pass --no-user-merge om over te slaan, of --uid-fields en --reset-imported-passwords indien nodig. Zie het herstelgedeelte en de 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.