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.
Requisitos
- WP-CLI instalado no servidor (ou sessão SSH).
- Plug-in Multisite Migrate ativo; execute comandos da raiz do WordPress (
wpdeve carregar o site). - Licença profissional - todos os comandos, exceto
ajudarequer Multisite Migrate Pro. As licenças Plus e Free não podem usar WP-CLI. - Capacidade do WordPress:
gerenciar_opções(local único) ougerenciar_rede(tarefas de rede multisite).
Primeiros passos
ajuda do wp multisite-migrate
ajuda wp multisite-migrate --topic=restore
backup wp multisite-migrate --help
lista de migração multisite wp ajuda imprime uma árvore de comandos completa, notas de recursos e exemplos de copiar e colar. Usar --topic=backup|restaurar|importar|jobs|installer|recovery|staging|caps para filtrar seções. Sinalizadores por comando são documentados com WP-CLI nativo --ajuda.
Árvore de comandos
| Comando | Objetivo |
|---|---|
cópia de segurança | Execute uma tarefa de backup (upload na nuvem local e opcional) |
restaurar <id do trabalho> | Restauração no mesmo servidor ou migração de URL com opções de topologia |
importar | Registre o arquivo do disco, URL ou nuvem; restauração encadeada opcional |
lista | Listar trabalhos de backup ou restauração concluídos |
status <id do trabalho> | Progresso do trabalho, porcentagem e metadados |
cancelar <id do trabalho> | Cancelar um trabalho em execução |
excluir <id do trabalho> | Excluir registro de trabalho e arquivo local quando presente |
pré-busca <job-id> | Baixe o backup somente na nuvem antes da restauração |
manifesto <job-id> | Imprimir manifesto de arquivo JSON |
visualização da migração <job-id> | Visualizar URL e mapeamento de tabela para migração |
informações | Versão do plug-in, mecanismo e resumo da licença |
saúde | Extensões PHP, espaço em disco, caminhos de armazenamento |
limpeza | Remover importação temporária e arquivos de trabalho |
podar | Aplicar política de retenção a backups locais antigos |
instalador | Implante o instalador ao lado de um backup ou baixe o bootstrap do PHP |
recuperação | Definir, iniciar ou redefinir o ponto de recuperação de desastres |
lista-remote <canal> | Listar backups remotos (gdrive, s3, sftp, dropbox) |
encenação | Criar, excluir ou enviar por push para um subsite de teste |
ajuda | Imprima esta referência no terminal |
Cópia de segurança
backup de migração multisite wp
wp multisite-migrate backup --upload --destination=gdrive
backup wp multisite-migrate --scope=network --profile=full
backup wp multisite-migrate --scope=subsite --profile=db --incremental Sinalizadores comuns: --carregar, --destino=local|gdrive|s3|sftp|ftp|dropbox, --scope=rede|subsite, --profile=full|db|files|media|plugins|themes|custom, --incremental, --quieto.
O upload na nuvem requer armazenamento em nuvem Plus/Pro configurado em Armazenamento em nuvem. O escopo da rede requer Pro (CAP_MULTISITE).
Restaurar
wp multisite-migrate restaurar 42 --sim
wp multisite-migrate restaurar 42 --mode=db --no-safety-snapshot
wp multisite-migrate restaurar 42 --migration --old-url=https://old.example --new-url=https://new.example --yes Espelho de sinalizadores de topologia Restauração avançada na interface do administrador:
--topology-import=subsite_on_network+--topologia-target-url=…— backup de subsite em uma rede existente--topology-import=network_to_subsite+--topologia-target-blog-id=…— backup de rede em um slot de subsite--prefix-policy=keep_source|remap_wp,--blog-domains=<json>,--senha=…para.venc
Restaurações longas mostram uma barra de progresso. O instantâneo de segurança é executado, a menos que --no-safety-snapshot. Usar --sim para pular a confirmação de substituição.
Importar
importação multisite-migrate wp /var/backups/site.zip
importação wp multisite-migrate --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 URL remoto e canais de nuvem exigem Pro (CAP_REMOTE_IMPORT). Corrente --restaurar para iniciar a restauração imediatamente; adicionar --via-trabalhador para restauração no plug-in em vez de implantação do instalador.
Gerenciamento de trabalho
lista wp multisite-migrate --type=backup --format=table --limit=50
status de migração multisite wp 42
wp multisite-migrate cancelar 42
wp multisite-migrate excluir 42
wp multisite-migrate manifesto 42
wp multisite-migrate migração-visualização 42 lista suporta --format=tabela|json|csv. Os administradores de subsite em vários sites veem apenas seu escopo, a menos que tenham limite de rede.
Instalador e servidor vazio
instalador wp multisite-migrate 42
instalador wp multisite-migrate 42 --bridge
download do instalador wp multisite-migrate --type = php
download do instalador wp multisite-migrate 42 --type=php Implanta o mesmo assistente que Importar → Abrir instalador. --ponte usa proxy wp-admin MU-plugin quando os arquivos estão protegidos. baixar escreve bootstrap PHP ao lado do seu shell (Pro CAP_INSTALLER).
Veja também Migração de servidor vazio.
Recuperação de desastres
conjunto de recuperação wp multisite-migrate --job-id = 42
status de recuperação de migração multisite wp
lançamento de recuperação wp multisite-migrate
redefinição de recuperação de migração multisite wp Partidas Backups → Recuperação: substituição no local de um backup completo fixado com núcleo do WordPress. Desative todo o site com define('MM_DISALLOW_RECOVERY', verdadeiro); em wp-config.php.
Encenação
wp multisite-migrate staging create --slug=staging --title="Staging"
wp multisite-migrate staging delete --slug=staging
wp multisite-migrate teste push --job-id=42 Requer Profissional CAP_STAGING. Mesmos fluxos que Preparação no guia de restauração.
Manutenção
informações de migração multisite wp
wp multisite-migrate saúde
limpeza de migração multisite wp
remoção de migração multisite wp
wp multisite-migrate lista-remoto gdrive Capacidades 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 | Todos os comandos exceto ajuda - Somente profissional |
CAP_CLOUD | backup --carregar, pré-busca, lista remota |
CAP_REMOTE_IMPORT | importar --url, importar --de=* |
CAP_MULTISITE | backup|restaurar --scope=rede |
CAP_INSTALLER | download do instalador |
CAP_STAGING | encenação * |
Receitas de cenário
| Cenário | Comandos |
|---|---|
| Subsite → migração autônoma | restauração de migração multisite wp <id> --migration --old-url=… --new-url=… --yes |
| Subsite → rede existente | restauração de migração multisite wp <id> --topology-import=subsite_on_network --topology-target-url=… --yes |
| Rede → slot de subsite | restauração de migração multisite wp <id> --topology-import=network_to_subsite --topology-target-blog-id=… --yes |
| Importe e instale o instalador | wp multisite-migrate import /path/backup.zip --restore |
| Importe e restaure no plugin | wp multisite-migrate import /path/backup.zip --restore --via-worker --yes |
| Backup somente na nuvem → restauração | pré-busca wp multisite-migrate <id> então restauração de migração multisite wp <id> --sim |
| Implantar instalador (ponte) | instalador wp multisite-migrate <id> --ponte |
| Ponto de recuperação de desastres | conjunto de recuperação wp multisite-migrate --job-id=<id> então lançamento de recuperação |
Bandeiras globais
--quieto— suprimir mensagens de progresso em trabalhos longos--porcelana— linhas de progresso legíveis por máquina
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.
O reembolso de 14 dias se aplica se eu usar apenas o WP-CLI?
Sim. As novas compras Plus ou Pro incluem uma garantia de devolução do dinheiro de 14 dias, independentemente de você preferir UI de administrador ou WP-CLI.