WP-CLI
Referência WP-CLI (Pro)
Automatize backups, restaurações, importações, implantação de instalador, recuperação de desastres e preparação a partir do shell. Paridade total com a interface de administração do Multisite Migrate – licença Pro necessária para todos os comandos, exceto ajuda.
Requisitos
- WP-CLI installed on the server (or SSH session).
- Multisite Migrate plugin active; run commands from the WordPress root (
wpmust load the site). - Licença profissional — 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).
Primeiros passos
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.
Árvore de comandos
| Comando | Objetivo |
|---|---|
backup | Execute uma tarefa de backup (upload na nuvem local e opcional) |
restore <job-id> | Restauração no mesmo servidor ou migração de URL com opções de topologia |
import | Registre o arquivo do disco, URL ou nuvem; restauração encadeada opcional |
list | Listar trabalhos de backup ou restauração concluídos |
status <job-id> | Progresso do trabalho, porcentagem e metadados |
cancel <job-id> | Cancelar um trabalho em execução |
delete <job-id> | Excluir registro de trabalho e arquivo local quando presente |
prefetch <job-id> | Baixe o backup somente na nuvem antes da restauração |
manifest <job-id> | Imprimir manifesto de arquivo JSON |
migration-preview <job-id> | Visualizar URL e mapeamento de tabela para migração |
info | Versão do plug-in, mecanismo e resumo da licença |
health | Extensões PHP, espaço em disco, caminhos de armazenamento |
cleanup | Remover importação temporária e arquivos de trabalho |
prune | Aplicar política de retenção a backups locais antigos |
installer | Implante o instalador ao lado de um backup ou baixe o bootstrap do PHP |
recovery | Definir, iniciar ou redefinir o ponto de recuperação de desastres |
list-remote <channel> | Listar backups remotos (gdrive, s3, sftp, dropbox) |
staging | Criar, excluir ou enviar por push para um subsite de teste |
help | Imprima esta referência no terminal |
Cópia de segurança
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.
O upload na nuvem requer armazenamento em nuvem Plus/Pro configurado em Armazenamento em nuvem. O escopo da rede está disponível para administradores de rede no Free+; Os trabalhos de rede subsite-admin ainda seguem regras de assento/capacidade.
Restaurar
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 --yesAs flags de topologia espelham Restore Multisite na interface de administração:
--topology-import=subsite_on_network+--topology-target-url=…— backup de subsite para uma rede existente--topology-import=network_to_subsite+--topology-target-blog-id=…— backup de rede em um slot de subsite--prefix-policy=keep_source|remap_wp,--blog-domains=<json>,--passphrase=…para.venc- Mesclar usuários compartilhados (ativado por padrão nos dois modos de aterrissagem na rede):
--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 --yesRestaurações longas mostram uma barra de progresso. O snapshot de segurança é executado salvo --no-safety-snapshot. Use --yes para pular a confirmação de sobrescrita.
Importaçãoaçãoaçãoaçãoaçãoar
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.
Gerenciamento de trabalho
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.
Instalador e servidor vazio
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=phpImplanta o mesmo assistente que Importaçãoaçãoaçãoaçãoaçãoar → Abrir instalador. --bridge uses wp-admin MU-plugin proxy when archives are protected. download writes bootstrap PHP beside your shell (Pro CAP_INSTALLER).
See also Migração empty-server.
Recuperação de desastres
wp multisite-migrate recovery set --job-id=42
wp multisite-migrate recovery status
wp multisite-migrate recovery launch
wp multisite-migrate recovery resetPartidas Backups → Recuperação: in-place overwrite from a pinned full backup with WordPress core. Disable site-wide with define('MM_DISALLOW_RECOVERY', true); in wp-config.php.
Encenação
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 no guia de restore.
Manutenção
wp multisite-migrate info
wp multisite-migrate health
wp multisite-migrate cleanup
wp multisite-migrate prune
wp multisite-migrate list-remote gdriveCapacidades de licença
Após o portão Pro, comandos individuais podem exigir recursos secundários (iguais à interface do administrador):
| Capacidade | Exemplos de 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 | Fluxos administrativos em toda a rede que exigem o portão de capacidade multissite (consulte a ajuda da 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 |
Receitas de cenário
| Cenário | Comandos |
|---|---|
| Subsite → migração autônoma | wp multisite-migrate restore <id> --migration --old-url=… --new-url=… --yes |
| Rede dividida → arquivos por site | wp multisite-migrate split-network --yes then split-status — see guia de divisão de rede |
| Retomar divisão com falha | wp multisite-migrate split-resume --yes then split-status |
| Arquivo de rede → um site independente | wp multisite-migrate restore <id> --migration --topology-import=extract_site_standalone --source-blog-id=N --old-url=… --new-url=… --yes then migration-verify |
| Verifique URLs restantes | wp multisite-migrate migration-verify --old-url=… |
| Pesquisa-substituição confirmada | wp multisite-migrate search-replace --old=… --new=… --yes |
| Subsite → rede existente (mesclar usuários) | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --yes |
| Rede → slot de subsite (mesclar usuários) | wp multisite-migrate restore <id> --topology-import=network_to_subsite --topology-target-blog-id=… --user-merge --yes |
| Importaçãoaçãoaçãoaçãoaçãoação de rede sem mesclagem de usuários | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --no-user-merge --yes |
| Mesclar usuários + redefinir senhas | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --reset-imported-passwords --send-password-reset-email --yes |
| Importaçãoaçãoaçãoaçãoaçãoe e instale o instalador | wp multisite-migrate import /path/backup.zip --restore |
| Importaçãoaçãoaçãoaçãoaçãoe e restaure no plugin | wp multisite-migrate import /path/backup.zip --restore --via-worker --yes |
| Backup somente na nuvem → restauração | wp multisite-migrate prefetch <id> then wp multisite-migrate restore <id> --yes |
| Implantar instalador (ponte) | wp multisite-migrate installer <id> --bridge |
| Ponto de recuperação de desastres | wp multisite-migrate recovery set --job-id=<id> then recovery launch |
Bandeiras globais
--quiet— suppress progress messages on long jobs--porcelain— machine-readable progress lines
Guias relacionados
Perguntas frequentes sobre WP-CLI
A automação do Shell requer Pro. Use a ajuda no servidor para obter a lista de comandos ativos.
Qual licença eu preciso para WP-CLI?
Pró. Free e Plus não podem executar comandos WP-CLI do Multisite Migrate (exceto visualizar a ajuda quando disponível).
Onde devo executar comandos wp?
Da raiz do WordPress, o WP-CLI carrega o site. O plugin Multisite Migrate deve estar ativo.
Posso automatizar agendamentos via CLI?
Sim no Pro – os comandos de backup, restauração, importação, instalador, recuperação e teste espelham a UI do administrador. Veja a seção de receitas acima.
Como faço para mesclar usuários ao restaurar em uma rede via WP-CLI?
Use --topology-import=subsite_on_network ou network_to_subsite. A mesclagem de usuários compartilhados está ativada por padrão; passe --no-user-merge para pular ou --uid-fields e --reset-imported-passwords conforme necessário. Veja a seção de restauração e receitas acima.
O reembolso do dia 14 se aplica se eu usar apenas o WP-CLI?
Sim. As novas compras Plus ou Pro incluem uma garantia de devolução do dinheiro em dias 14, independentemente de você preferir UI de administrador ou WP-CLI.