WP-CLI
Referencia de WP-CLI (Pro)
Automatice copias de seguridad, restauraciones, importaciones, implementación de instaladores, recuperación ante desastres y preparación desde el shell. Paridad total con la interfaz de usuario de administración de Multisite Migrate: se requiere licencia Pro para todos los comandos excepto la ayuda.
Requisitos
- WP-CLI installed on the server (or SSH session).
- Multisite Migrate plugin active; run commands from the WordPress root (
wpmust load the site). - licencia profesional — 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).
Empezando
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.
árbol de comandos
| Comando | Propósito |
|---|---|
backup | Ejecute una tarea de respaldo (carga en la nube local y opcional) |
restore <job-id> | Restauración en el mismo servidor o migración de URL con opciones de topología |
import | Registre el archivo desde el disco, la URL o la nube; restauración encadenada opcional |
list | Listar trabajos de copia de seguridad o restauración completados |
status <job-id> | Progreso del trabajo, porcentaje y metadatos |
cancel <job-id> | Cancelar un trabajo en ejecución |
delete <job-id> | Eliminar registro de trabajo y archivo local cuando esté presente |
prefetch <job-id> | Descargue la copia de seguridad solo en la nube antes de restaurar |
manifest <job-id> | Imprimir manifiesto de archivo JSON |
migration-preview <job-id> | Vista previa de URL y asignación de tablas para la migración |
info | Resumen de versión, motor y licencia del complemento |
health | Extensiones PHP, espacio en disco, rutas de almacenamiento |
cleanup | Eliminar archivos de importación y de trabajo temporales |
prune | Aplicar política de retención a copias de seguridad locales antiguas |
installer | Implemente el instalador junto a una copia de seguridad o descargue PHP de arranque |
recovery | Establecer, iniciar o restablecer el punto de recuperación ante desastres |
list-remote <channel> | Listar copias de seguridad remotas (gdrive, s3, sftp, dropbox) |
staging | Crear, eliminar o enviar a un subsitio de prueba |
help | Imprimir esta referencia en la terminal |
Copia de seguridad
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.
La carga en la nube requiere almacenamiento en la nube Plus/Pro configurado en Almacenamiento en la nube. El alcance de la red está disponible para los administradores de red en Free+; Los trabajos de red de administrador de subsitio aún siguen las reglas de asiento/capacidad.
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 --yes Los indicadores de topología reflejan Restore Multisite en la interfaz de administración:
--topology-import=subsite_on_network+--topology-target-url=…— backup de subsitio sobre una red existente--topology-import=network_to_subsite+--topology-target-blog-id=…— backup de red en un hueco de subsitio--prefix-policy=keep_source|remap_wp,--blog-domains=<json>,--passphrase=…para.venc- Fusión de usuarios compartidos (activado por defecto en los dos modos que aterrizan en la red):
--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 Las restauraciones largas muestran una barra de progreso. El snapshot de seguridad se ejecuta salvo --no-safety-snapshot. Use --yes para omitir la confirmación de sobrescritura.
Importaciónaciónaciónaciónaciónar
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.
Gestión del trabajo
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.
Instalador y servidor vacío
wp multisite-migrate installer 42
wp multisite-migrate installer 42 --bridge
wp multisite-migrate installer descarga --type=php
wp multisite-migrate installer descarga 42 --type=php Implementa el mismo asistente que Importaciónaciónaciónaciónaciónar → Abrir instalador. --bridge uses wp-admin MU-plugin proxy when archives are protected. descarga writes bootstrap PHP beside your shell (Pro CAP_INSTALLER).
See also Migración a servidor vacío.
Recuperación ante desastres
wp multisite-migrate recovery set --job-id=42
wp multisite-migrate recovery status
wp multisite-migrate recovery launch
wp multisite-migrate recovery reset Partidos Copias de seguridad → Recuperación: 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 en la guía de restore.
Mantenimiento
wp multisite-migrate info
wp multisite-migrate health
wp multisite-migrate cleanup
wp multisite-migrate prune
wp multisite-migrate list-remote gdrive Capacidades de licencia
Después de la puerta Pro, los comandos individuales pueden requerir capacidades secundarias (igual que la interfaz de usuario de administración):
| Capacidad | Ejemplos 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 | Flujos de administración en toda la red que requieren la puerta de capacidad multisitio (consulte la ayuda de CLI) |
CAP_INSTALLER | installer descarga |
CAP_STAGING | staging * |
CAP_NETWORK_SPLIT | split-network, split-status, split-cancel, split-resume, restore --topology-import=extract_site_standalone |
Recetas de escenarios
| Escenario | Comandos |
|---|---|
| Subsitio → migración independiente | wp multisite-migrate restore <id> --migration --old-url=… --new-url=… --yes |
| Red dividida → archivos por sitio | wp multisite-migrate split-network --yes then split-status — see guía de división de red |
| Reanudar división fallida | wp multisite-migrate split-resume --yes then split-status |
| Archivo de red → un sitio independiente | wp multisite-migrate restore <id> --migration --topology-import=extract_site_standalone --source-blog-id=N --old-url=… --new-url=… --yes then migration-verify |
| Verificar las URL sobrantes | wp multisite-migrate migration-verify --old-url=… |
| Búsqueda-reemplazo confirmado | wp multisite-migrate search-replace --old=… --new=… --yes |
| Subsitio → red existente (fusionar usuarios) | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --yes |
| Red → espacio de subsitio (fusionar usuarios) | wp multisite-migrate restore <id> --topology-import=network_to_subsite --topology-target-blog-id=… --user-merge --yes |
| Importaciónaciónaciónaciónaciónación de red sin fusión de usuarios | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --no-user-merge --yes |
| Fusionar usuarios + restablecer contraseñas | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --reset-imported-passwords --send-password-reset-email --yes |
| Importaciónaciónaciónaciónaciónar y luego instalar | wp multisite-migrate import /path/backup.zip --restore |
| Importaciónaciónaciónaciónaciónar y luego restaurar en el complemento | wp multisite-migrate import /path/backup.zip --restore --via-worker --yes |
| Copia de seguridad solo en la nube → restaurar | wp multisite-migrate prefetch <id> then wp multisite-migrate restore <id> --yes |
| Implementar instalador (puente) | wp multisite-migrate installer <id> --bridge |
| Punto de recuperación ante desastres | wp multisite-migrate recovery set --job-id=<id> then recovery launch |
Banderas globales
--quiet— suppress progress messages on long jobs--porcelain— machine-readable progress lines
Guías relacionadas
Preguntas frecuentes sobre WP-CLI
La automatización de Shell requiere Pro. Utilice la ayuda del servidor para obtener la lista de comandos en vivo.
¿Qué licencia necesito para WP-CLI?
Pro. Free y Plus no pueden ejecutar comandos WP-CLI de Multisite Migrate (excepto para ver la ayuda cuando esté disponible).
¿Dónde debería ejecutar los comandos de wp?
Desde la raíz de WordPress, WP-CLI carga el sitio. El plugin Multisite Migrate debe estar activo.
¿Puedo automatizar horarios a través de CLI?
Sí en Pro: los comandos de copia de seguridad, restauración, importación, instalación, recuperación y preparación reflejan la interfaz de usuario del administrador. Consulte la sección de recetas anterior.
¿Cómo fusiono usuarios al restaurar en una red a través de WP-CLI?
Utilice --topology-import=subsite_on_network o network_to_subsite. La combinación de usuarios compartidos está activada de forma predeterminada; pase --no-user-merge para omitir, o --uid-fields y --reset-imported-passwords según sea necesario. Consulte la sección de restauración y las recetas anteriores.
¿Se aplica el reembolso de 14-día si solo uso WP-CLI?
Sí. Las compras nuevas Plus o Pro incluyen una garantía de devolución de dinero de 14 días, independientemente de si prefiere la interfaz de usuario de administrador o WP-CLI.