WP-CLI
Référence WP-CLI (Pro)
Automatisez les sauvegardes, les restaurations, les importations, le déploiement du programme d'installation, la reprise après sinistre et la préparation à partir du shell. Parité totale avec l'interface utilisateur d'administration de Multisite Migrate — Licence Pro requise pour chaque commande, à l'exception de l'aide.
Exigences
- WP-CLI installed on the server (or SSH session).
- Multisite Migrate plugin active; run commands from the WordPress root (
wpmust load the site). - Licence Pro — 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).
Commencer
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.
Arbre de commandes
| Commande | Objectif |
|---|---|
backup | Exécuter une tâche de sauvegarde (téléchargement cloud local et facultatif) |
restore <job-id> | Restauration sur le même serveur ou migration d'URL avec options de topologie |
import | Enregistrez l'archive à partir d'un disque, d'une URL ou d'un cloud ; restauration chaînée facultative |
list | Répertorier les tâches de sauvegarde ou de restauration terminées |
status <job-id> | Progression de la tâche, pourcentage et métadonnées |
cancel <job-id> | Annuler une tâche en cours |
delete <job-id> | Supprimer l'enregistrement de travail et les archives locales lorsqu'elles sont présentes |
prefetch <job-id> | Téléchargez la sauvegarde dans le cloud uniquement avant la restauration |
manifest <job-id> | Imprimer le manifeste d'archive JSON |
migration-preview <job-id> | Aperçu du mappage d'URL et de table pour la migration |
info | Version du plugin, moteur et résumé de la licence |
health | Extensions PHP, espace disque, chemins de stockage |
cleanup | Supprimer les fichiers d'importation et de travail temporaires |
prune | Appliquer la politique de rétention aux anciennes sauvegardes locales |
installer | Déployer le programme d'installation à côté d'une sauvegarde ou télécharger bootstrap PHP |
recovery | Définir, lancer ou réinitialiser un point de récupération après sinistre |
list-remote <channel> | Lister les sauvegardes à distance (gdrive, s3, sftp, dropbox) |
staging | Créer, supprimer ou transférer vers un sous-site intermédiaire |
help | Imprimez cette référence dans le terminal |
Sauvegarde
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.
Le téléchargement vers le cloud nécessite un stockage cloud Plus/Pro configuré dans Stockage en nuage. L'étendue du réseau est disponible pour les administrateurs réseau sur Free+ ; Les tâches réseau d'administrateur de sous-site suivent toujours les règles de siège/capacité.
Restaurer
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 --yesLes indicateurs de topologie reflètent Restauration Multisite dans l’interface d’administration :
--topology-import=subsite_on_network+--topology-target-url=…— sauvegarde de sous-site vers un réseau existant--topology-import=network_to_subsite+--topology-target-blog-id=…— sauvegarde réseau dans un emplacement de sous-site--prefix-policy=keep_source|remap_wp,--blog-domains=<json>,--passphrase=…pour.venc- Fusion des utilisateurs partagés (activé par défaut pour les deux modes d’atterrissage réseau) :
--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 --yesLes restaurations longues affichent une barre de progression. Le snapshot de sécurité s’exécute sauf --no-safety-snapshot. Utilisez --yes pour ignorer la confirmation d’écrasement.
Importer
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.
Gestion des tâches
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 et amp; serveur vide
wp multisite-migrate installer 42
wp multisite-migrate installer 42 --bridge
wp multisite-migrate installer téléchargement --type=php
wp multisite-migrate installer téléchargement 42 --type=phpDéploie le même assistant que Importer → Ouvrir le programme d'installation. --bridge uses wp-admin MU-plugin proxy when archives are protected. téléchargement writes bootstrap PHP beside your shell (Pro CAP_INSTALLER).
See also Migration empty-server.
Reprise après sinistre
wp multisite-migrate recovery set --job-id=42
wp multisite-migrate recovery status
wp multisite-migrate recovery launch
wp multisite-migrate recovery resetMatchs Sauvegardes → Récupération: 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 dans le guide de restauration.
Entretien
wp multisite-migrate info
wp multisite-migrate health
wp multisite-migrate cleanup
wp multisite-migrate prune
wp multisite-migrate list-remote gdriveCapacités de licence
Après la porte Pro, les commandes individuelles peuvent nécessiter des fonctionnalités secondaires (identiques à l'interface utilisateur d'administration) :
| Capacité | Exemples 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 | Flux d'administration à l'échelle du réseau qui nécessitent la porte de capacité multisite (voir l'aide CLI) |
CAP_INSTALLER | installer téléchargement |
CAP_STAGING | staging * |
CAP_NETWORK_SPLIT | split-network, split-status, split-cancel, split-resume, restore --topology-import=extract_site_standalone |
Recettes de scénarios
| Scénario | Commandes |
|---|---|
| Sous-site → migration autonome | wp multisite-migrate restore <id> --migration --old-url=… --new-url=… --yes |
| Réseau divisé → archives par site | wp multisite-migrate split-network --yes then split-status — see guide de découpage réseau |
| Reprendre le fractionnement ayant échoué | wp multisite-migrate split-resume --yes then split-status |
| Archive réseau → un site autonome | wp multisite-migrate restore <id> --migration --topology-import=extract_site_standalone --source-blog-id=N --old-url=… --new-url=… --yes then migration-verify |
| Vérifier les URL restantes | wp multisite-migrate migration-verify --old-url=… |
| Recherche-remplacement confirmé | wp multisite-migrate search-replace --old=… --new=… --yes |
| Sous-site → réseau existant (fusionner les utilisateurs) | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --yes |
| Réseau → emplacement de sous-site (fusionner les utilisateurs) | wp multisite-migrate restore <id> --topology-import=network_to_subsite --topology-target-blog-id=… --user-merge --yes |
| Importation réseau sans fusion d'utilisateurs | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --no-user-merge --yes |
| Fusionner les utilisateurs + réinitialiser les mots de passe | wp multisite-migrate restore <id> --topology-import=subsite_on_network --topology-target-url=… --user-merge --reset-imported-passwords --send-password-reset-email --yes |
| Importer puis installer | wp multisite-migrate import /path/backup.zip --restore |
| Importer puis restaurer dans le plugin | wp multisite-migrate import /path/backup.zip --restore --via-worker --yes |
| Sauvegarde cloud uniquement → restauration | wp multisite-migrate prefetch <id> then wp multisite-migrate restore <id> --yes |
| Déployer le programme d'installation (pont) | wp multisite-migrate installer <id> --bridge |
| Point de récupération après sinistre | wp multisite-migrate recovery set --job-id=<id> then recovery launch |
Drapeaux mondiaux
--quiet— suppress progress messages on long jobs--porcelain— machine-readable progress lines
Guides associés
FAQ WP CLI
L’automatisation Shell nécessite Pro. Utilisez l'aide sur le serveur pour la liste des commandes en direct.
De quelle licence ai-je besoin pour WP-CLI ?
Pro. Free et Plus ne peuvent pas exécuter les commandes WP-CLI Multisite Migrate (sauf pour afficher l'aide lorsqu'elle est disponible).
Où dois-je exécuter les commandes wp ?
Depuis la racine de WordPress donc WP-CLI charge le site. Le plugin Multisite Migrate doit être actif.
Puis-je automatiser les planifications via CLI ?
Oui sur Pro : les commandes de sauvegarde, de restauration, d'importation, d'installation, de récupération et de transfert reflètent l'interface utilisateur d'administration. Voir la section recettes ci-dessus.
Comment fusionner des utilisateurs lors d'une restauration sur un réseau via WP-CLI ?
Utilisez --topology-import=subsite_on_network ou network_to_subsite. La fusion des utilisateurs partagés est activée par défaut ; passez --no-user-merge pour ignorer, ou --uid-fields et --reset-imported-passwords si nécessaire. Voir la section de restauration et les recettes ci-dessus.
Le remboursement 14 jours s'applique-t-il si j'utilise uniquement WP-CLI ?
Oui. Les nouveaux achats Plus ou Pro incluent une garantie de remboursement d'un jour 14, que vous préfériez l'interface utilisateur d'administration ou WP-CLI.