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.
Exigences
- WP-CLI installé sur le serveur (ou session SSH).
- Plugin de migration multisite actif ; exécuter des commandes à partir de la racine de WordPress (
wpdoit charger le site). - Licence Pro — chaque commande sauf
aidenécessite Multisite Migrate Pro. Les licences Plus et Free ne peuvent pas utiliser WP-CLI. - Capacité WordPress :
gérer_options(site unique) ougérer_réseau(tâches réseau multisites).
Commencer
aide wp multisite-migrate
wp multisite-migrate aide --topic=restore
wp sauvegarde multisite-migrate --help
wp liste de migration multisite aide imprime une arborescence de commandes complète, des notes sur les fonctionnalités et des exemples de copier-coller. Utiliser --topic=sauvegarde|restauration|importation|jobs|installer|récupération|staging|caps pour filtrer les sections. Les indicateurs par commande sont documentés avec WP-CLI natif --aide.
Arbre de commandes
| Commande | Objectif |
|---|---|
sauvegarde | Exécuter une tâche de sauvegarde (téléchargement cloud local et facultatif) |
restaurer <ID-travail> | Restauration sur le même serveur ou migration d'URL avec options de topologie |
importer | Enregistrez l'archive à partir d'un disque, d'une URL ou d'un cloud ; restauration chaînée facultative |
liste | Répertorier les tâches de sauvegarde ou de restauration terminées |
statut <ID-travail> | Progression de la tâche, pourcentage et métadonnées |
annuler <ID-travail> | Annuler une tâche en cours |
supprimer <ID-travail> | Supprimer l'enregistrement de travail et les archives locales lorsqu'elles sont présentes |
prélecture <ID-travail> | 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 |
infos | Version du plugin, moteur et résumé de la licence |
santé | Extensions PHP, espace disque, chemins de stockage |
nettoyage | Supprimer les fichiers d'importation et de travail temporaires |
pruneau | Appliquer la politique de rétention aux anciennes sauvegardes locales |
installateur | Déployer le programme d'installation à côté d'une sauvegarde ou télécharger bootstrap PHP |
récupération | Définir, lancer ou réinitialiser un point de récupération après sinistre |
liste-distant <canal> | Lister les sauvegardes à distance (gdrive, s3, sftp, dropbox) |
mise en scène | Créer, supprimer ou transférer vers un sous-site intermédiaire |
aide | Imprimez cette référence dans le terminal |
Sauvegarde
wp sauvegarde de migration multisite
wp sauvegarde multisite-migrate --upload --destination=gdrive
wp sauvegarde multisite-migrate --scope=network --profile=full
wp sauvegarde multisite-migrate --scope=subsite --profile=db --incremental Drapeaux courants : --télécharger, --destination=local|gdrive|s3|sftp|ftp|dropbox, --scope=réseau|sous-site, --profile=full|db|files|media|plugins|themes|custom, --incrémental, --calme.
Le téléchargement vers le cloud nécessite un stockage cloud Plus/Pro configuré dans Stockage en nuage. La portée du réseau nécessite Pro (CAP_MULTISITE).
Restaurer
wp multisite-migrate restauration 42 --oui
wp multisite-migrate restauration 42 --mode=db --no-safety-snapshot
wp multisite-migrate restaurer 42 --migration --old-url=https://old.example --new-url=https://new.example --yes Miroir des indicateurs de topologie Restauration avancée dans l'interface d'administration :
--topology-import=subsite_on_network+--topologie-target-url=…— sauvegarde du sous-site sur 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>,--phrase secrète =…pour.venc
Les restaurations longues affichent une barre de progression. L'instantané de sécurité s'exécute sauf si --pas d'instantané de sécurité. Utiliser --oui 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 --yes Les URL distantes et les canaux cloud nécessitent Pro (CAP_REMOTE_IMPORT). Chaîne --restaurer pour lancer la restauration immédiatement ; ajouter --via-travailleur pour la restauration dans le plugin au lieu du déploiement du programme d'installation.
Gestion des tâches
wp multisite-migrate list --type=backup --format=table --limit=50
statut de migration multisite wp 42
wp multisite-migrate annuler 42
wp multisite-migrate supprimer 42
wp multisite-migrate manifeste 42
wp multisite-migrate migration-aperçu 42 liste prend en charge --format=table|json|csv. Les administrateurs de sous-site sur multisite voient uniquement leur portée, sauf s'ils disposent d'une limite de réseau.
Installateur et amp; serveur vide
programme d'installation wp multisite-migrate 42
wp multisite-migrate installateur 42 --bridge
Téléchargement du programme d'installation de wp multisite-migrate --type=php
téléchargement du programme d'installation wp multisite-migrate 42 --type=php Déploie le même assistant que Importer → Ouvrir le programme d'installation. --pont utilise le proxy wp-admin MU-plugin lorsque les archives sont protégées. télécharger écrit PHP bootstrap à côté de votre shell (Pro CAP_INSTALLATEUR).
Voir aussi Migration de serveur vide.
Reprise après sinistre
ensemble de récupération wp multisite-migrate --job-id=42
état de récupération wp multisite-migrate
lancement de la récupération wp multisite-migrate
Réinitialisation de la récupération wp multisite-migrate Matchs Sauvegardes → Récupération: écrasement sur place à partir d'une sauvegarde complète épinglée avec le noyau WordPress. Désactivez l'ensemble du site avec définir('MM_DISALLOW_RECOVERY', vrai); dans wp-config.php.
Mise en scène
wp multisite-migrate staging créer --slug=staging --title="Staging"
wp multisite-migrate staging supprimer --slug=staging
wp multisite-migrate staging push --job-id=42 Nécessite Pro CAP_STAGING. Mêmes flux que Mise en scène dans le guide de restauration.
Entretien
informations sur la migration multisite wp
wp multisite-migrate santé
wp nettoyage de migration multisite
wp multisite-migrate prune
wp multisite-migrate list-remote gdrive Capacité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 | Toutes les commandes sauf aide -Pro uniquement |
CAP_CLOUD | sauvegarde --télécharger, prélecture, liste-distant |
CAP_REMOTE_IMPORT | importer --url, importer --from=* |
CAP_MULTISITE | sauvegarde|restauration --scope=réseau |
CAP_INSTALLATEUR | téléchargement du programme d'installation |
CAP_STAGING | mise en scène * |
Recettes de scénarios
| Scénario | Commandes |
|---|---|
| Sous-site → migration autonome | wp multisite-migrate restauration <id> --migration --old-url=… --new-url=… --oui |
| Sous-site → réseau existant | wp multisite-migrate restauration <id> --topology-import=subsite_on_network --topology-target-url=… --oui |
| Réseau → emplacement de sous-site | wp multisite-migrate restauration <id> --topology-import=network_to_subsite --topology-target-blog-id=… --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> alors wp multisite-migrate restauration <id> --oui |
| Déployer le programme d'installation (pont) | Le programme d'installation de wp multisite-migrate <id> --pont |
| Point de récupération après sinistre | wp multisite-migrate recovery set --job-id=<id> alors lancement de la récupération |
Drapeaux mondiaux
--calme— supprimer les messages de progression sur les travaux longs--porcelaine— lignes de progression lisibles par machine
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.
Le remboursement de 14 jours s'applique-t-il si j'utilise uniquement WP-CLI ?
Oui. Les nouveaux achats Plus ou Pro incluent une garantie de remboursement de 14 jours, que vous préfériez l'interface utilisateur d'administration ou WP-CLI.