WP-CLI
Riferimento WP-CLI (Pro)
Automatizza backup, ripristini, importazioni, distribuzione del programma di installazione, ripristino di emergenza e gestione temporanea dalla shell. Parità completa con l'interfaccia utente di amministrazione di Multisite Migrate: licenza Pro richiesta per ogni comando tranne la guida.
Requisiti
- WP-CLI installed on the server (or SSH session).
- Multisite Migrate plugin active; run commands from the WordPress root (
wpmust load the site). - Licenza professionale — 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).
Iniziare
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.
Albero dei comandi
| Comando | Scopo |
|---|---|
backup | Eseguire un processo di backup (caricamento cloud locale e opzionale) |
restore <job-id> | Ripristino dello stesso server o migrazione URL con opzioni di topologia |
import | Registra l'archivio da disco, URL o cloud; ripristino concatenato opzionale |
list | Elenca i processi di backup o ripristino completati |
status <job-id> | Avanzamento del lavoro, percentuale e metadati |
cancel <job-id> | Annulla un lavoro in esecuzione |
delete <job-id> | Elimina il record del lavoro e l'archivio locale quando presenti |
prefetch <job-id> | Scarica il backup solo su cloud prima del ripristino |
manifest <job-id> | Stampa il manifesto dell'archivio JSON |
migration-preview <job-id> | URL di anteprima e mappatura delle tabelle per la migrazione |
info | Versione del plugin, motore e riepilogo della licenza |
health | Estensioni PHP, spazio su disco, percorsi di archiviazione |
cleanup | Rimuovere l'importazione temporanea e i file di lavoro |
prune | Applica criteri di conservazione ai vecchi backup locali |
installer | Distribuisci il programma di installazione accanto a un backup o scarica PHP bootstrap |
recovery | Imposta, avvia o reimposta il punto di ripristino di emergenza |
list-remote <channel> | Elenca i backup remoti (gdrive, s3, sftp, dropbox) |
staging | Crea, elimina o invia a un sito secondario di gestione temporanea |
help | Stampa questo riferimento nel terminale |
Backup
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.
Il caricamento sul cloud richiede l'archiviazione cloud Plus/Pro configurato in Archiviazione nel cloud. L'ambito di rete è disponibile per gli amministratori di rete su Free+; i lavori di rete di amministrazione secondaria seguono ancora le regole di postazione/capacità.
Ripristina
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 I flag di topologia rispecchiano Restore Multisite nell’interfaccia di amministrazione:
--topology-import=subsite_on_network+--topology-target-url=…— backup del sito su una rete esistente--topology-import=network_to_subsite+--topology-target-blog-id=…— backup di rete in uno slot del sito--prefix-policy=keep_source|remap_wp,--blog-domains=<json>,--passphrase=…per.venc- Unione utenti condivisi (attivo per impostazione predefinita nei due modi di atterraggio sulla rete):
--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 --yes I ripristini lunghi mostrano una barra di avanzamento. Lo snapshot di sicurezza viene eseguito salvo --no-safety-snapshot. Usa --yes per saltare la conferma di sovrascrittura.
Importa
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.
Gestione del lavoro
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.
Installatore e; server vuoto
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 Distribuisce la stessa procedura guidata di Importa → Apri programma di installazione. --bridge uses wp-admin MU-plugin proxy when archives are protected. download writes bootstrap PHP beside your shell (Pro CAP_INSTALLER).
See also Migrazione empty-server.
Ripristino in caso di disastro
wp multisite-migrate recovery set --job-id=42
wp multisite-migrate recovery status
wp multisite-migrate recovery launch
wp multisite-migrate recovery reset Partite Backup → Ripristino: in-place overwrite from a pinned full backup with WordPress core. Disable site-wide with define('MM_DISALLOW_RECOVERY', true); in wp-config.php.
Messa in scena
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 nella guida al restore.
Manutenzione
wp multisite-migrate info
wp multisite-migrate health
wp multisite-migrate cleanup
wp multisite-migrate prune
wp multisite-migrate list-remote gdrive Funzionalità della licenza
Dopo l'accesso Pro, i singoli comandi potrebbero richiedere funzionalità secondarie (come l'interfaccia utente di amministrazione):
| Capacità | Esempi CLI |
|---|---|
CAP_CLI | All commands except help — Pro only |
CAP_CLOUD | backup --upload, prefetch, list-remote |
CAP_REMOTE_IMPORT | import --url, import --from=* |
CAP_MULTISITE | Flussi amministrativi a livello di rete che richiedono il gate di funzionalità multisito (vedere la guida CLI) |
CAP_INSTALLER | installer download |
CAP_STAGING | staging * |
CAP_NETWORK_SPLIT | split-network, split-status, split-cancel, split-resume, restore --topology-import=extract_site_standalone |
Ricette di scenari
| Scenario | Comandi |
|---|---|
| Sito secondario → migrazione autonoma | wp multisite-migrate restore <id> --migration --old-url=… --new-url=… --yes |
| Rete divisa → archivi per sito | wp multisite-migrate split-network --yes then split-status — see guida allo split di rete |
| Riprendi la divisione non riuscita | wp multisite-migrate split-resume --yes then split-status |
| Archivio di rete → un sito autonomo | wp multisite-migrate restore <id> --migration --topology-import=extract_site_standalone --source-blog-id=N --old-url=… --new-url=… --yes then migration-verify |
| Verifica gli URL rimanenti | wp multisite-migrate migration-verify --old-url=… |
| Ricerca-sostituzione confermata | wp multisite-migrate search-replace --old=… --new=… --yes |
| Sottosito → rete esistente (unisci utenti) | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --yes |
| Rete → slot del sito secondario (unisci utenti) | wp multisite-migrate restore <id> --topology-import=network_to_subsite --topology-target-blog-id=… --user-merge --yes |
| Importazione in rete senza unione degli utenti | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --no-user-merge --yes |
| Unisci utenti + reimposta password | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --reset-imported-passwords --send-password-reset-email --yes |
| Importa quindi programma di installazione | wp multisite-migrate import /path/backup.zip --restore |
| Importa e poi ripristina nel plugin | wp multisite-migrate import /path/backup.zip --restore --via-worker --yes |
| Backup solo cloud → ripristino | wp multisite-migrate prefetch <id> then wp multisite-migrate restore <id> --yes |
| Distribuire il programma di installazione (bridge) | wp multisite-migrate installer <id> --bridge |
| Punto di ripristino di emergenza | wp multisite-migrate recovery set --job-id=<id> then recovery launch |
Bandiere globali
--quiet— suppress progress messages on long jobs--porcelain— machine-readable progress lines
Guide correlate
Domande frequenti sulla CLI WP
L'automazione della shell richiede Pro. Utilizzare la guida sul server per l'elenco dei comandi live.
Di quale licenza ho bisogno per WP-CLI?
Pro. Free e Plus non possono eseguire comandi WP-CLI Multisite Migrate (ad eccezione della visualizzazione della guida, ove disponibile).
Dove dovrei eseguire i comandi wp?
Dalla root di WordPress quindi WP-CLI carica il sito. Il plugin Multisite Migrate deve essere attivo.
Posso automatizzare le pianificazioni tramite CLI?
Sì su Pro: i comandi di backup, ripristino, importazione, installazione, ripristino e gestione temporanea rispecchiano l'interfaccia utente di amministrazione. Vedi la sezione ricette qui sopra.
Come posso unire gli utenti durante il ripristino su una rete tramite WP-CLI?
Utilizzare --topology-import=subsite_on_network o network_to_subsite. L'unione degli utenti condivisi è attiva per impostazione predefinita; passa --no-user-merge per saltare, oppure --uid-fields e --reset-imported-passwords secondo necessità. Vedi la sezione di ripristino e le ricette sopra.
Il rimborso di 14-day si applica se utilizzo solo WP-CLI?
Sì. I nuovi acquisti Plus o Pro includono una garanzia di rimborso di 14 giorni, indipendentemente dal fatto che tu preferisca l'interfaccia utente di amministrazione o WP-CLI.