Avec la commande plan, tu gères tes plans de sauvegarde depuis la ligne de commande : afficher, créer, modifier, mettre en pause, activer, exécuter immédiatement et supprimer.
WP-CLI n’est pas encore installé ? Alors commence par Installer WP-CLI. Ce qui s’applique à chaque commande, par exemple l’utilisateur et le paramètre --force, se trouve dans Les commandes en un coup d’œil.
Un plan de sauvegarde regroupe quand une sauvegarde s’exécute, ce qu’elle contient, où elle va et combien de sauvegardes restent par destination. Tu indiques un plan par son identifiant, par exemple plan-1, ou par son nom. Pour les lettres a à z, la casse ne joue aucun rôle dans le nom ; tu écris les lettres accentuées telles qu’elles figurent dans le nom. Un nom contenant des espaces se met entre guillemets.
Chaque action sauf list vérifie que tu travailles en tant que l’utilisateur à qui appartiennent les dossiers de l’extension. --force passe outre cette vérification.
Afficher les plans : list
# Afficher tous les plans de sauvegarde avec état, rythme et prochaine exécution wp cloneworx-backup plan list
La sortie affiche deux lignes par plan. La première contient l’identifiant, l’état, le nom, le rythme avec l’heure de début et les identifiants des destinations. La seconde indique la prochaine exécution, la dernière exécution, le contenu, Sauvegardes max. et l’instantané. La dernière ligne compte les plans et les plans actifs. Si un plan actif ne s’exécute pas selon le planning, la raison figure sur une ligne à part sous le plan.
| Dans la sortie | Signification |
|---|---|
active |
Le plan est actif et s’exécute de lui-même à sa prochaine exécution. |
paused |
Le plan est en pause. Aucune sauvegarde n’est planifiée. |
paused (no target) |
Le plan est en pause parce qu’il n’a plus de destination. Choisis une destination, il pourra ensuite être activé. |
next run |
La prochaine exécution dans le fuseau horaire du site. Pour un plan en pause, un tiret figure ici. |
last run |
La dernière exécution avec son déclencheur : schedule (planification), manual (sur les pages de l’extension) ou cli (ligne de commande). missed indique une exécution manquée ensuite. could not start signifie : la dernière exécution planifiée n’a pas pu démarrer. Après le code entre parenthèses figure la raison en clair. |
roots |
Ce que le plan sauvegarde, sous forme de liste des zones. |
retention |
Sauvegardes max. |
snapshot |
Sauvegarder la base de données comme instantané : yes ou no
|
Créer un plan : add
# Sauvegarder tous les jours à 03:15 vers la destination sftp-1 wp cloneworx-backup plan add --target=sftp-1 --rhythm=daily --time=03:15 --name="Nachts" # Le dimanche à 22 h, base de données et téléversements, conserver 3 sauvegardes wp cloneworx-backup plan add --target=local-1 --rhythm=weekly --weekday=7 --time=22:00 --roots=db,wp-uploads --retention=3 # Activer le nouveau plan de sauvegarde wp cloneworx-backup plan resume "Nachts"
Seul --target est obligatoire. Tout le reste a une valeur par défaut.
| Paramètre | Signification | Valeurs autorisées |
|---|---|---|
--target=<identifiant> |
La destination du plan, dans le formulaire Destinations et rotation. Obligatoire. | L’identifiant d’une destination utilisable, pas son nom. Exactement une destination : la commande ne découpe pas la valeur à la virgule. wp pro-plan accepte plusieurs destinations avec --targets. |
--name=<nom> |
Le nom du plan. Sans ce paramètre, l’extension attribue sa proposition. | Au plus 100 caractères. Tout nom qu’aucun autre plan n’a encore convient. |
--rhythm=<Rhythmus> |
Rythme |
1h, 2h, 4h, 6h, 12h, daily, weekly, monthly. wp pro-plan accepte aussi 5m, 10m, 15m, 30m. Par défaut : daily. |
--time=HH:MM |
Heure dans le fuseau horaire du site. | Heure de 0 à 23, minutes 00, 15, 30 ou 45. Par défaut : une heure aléatoire. |
--weekday=<Zahl> |
Jour de la semaine, pour le rythme weekly. |
1 pour lundi à 7 pour dimanche. Par défaut : 1. |
--monthday=<Tag> |
Jour du mois, pour le rythme monthly. |
1 à 28, ou last pour le dernier jour du mois. Par défaut : 1. |
--roots=<Liste> |
Ce qui est sauvegardé : les zones, séparées par des virgules. | Voir le tableau des zones. Par défaut : toutes. La commande n’accepte pas wp-config : le fichier wp-config.php ne fait jamais partie d’une sauvegarde. |
--retention=<Zahl> |
Sauvegardes max. : autant de sauvegardes correctes sont conservées par destination. | 1 à 99. Par défaut : 7. 0 seulement avec la conservation par ancienneté de cloneworx Backup Pro. |
--snapshot=<Wert> |
Sauvegarder la base de données comme instantané |
yes ou no. Par défaut : yes. |
--force |
Passe outre la vérification de l’utilisateur. |
-
Un nouveau plan est en pause. Il ne s’exécute que lorsque tu l’actives avec
resume. - L’heure de démarrage peut différer de l’heure indiquée. À la création, l’extension ajoute au hasard 0 à 14 minutes et conserve ce supplément. 03:15 devient par exemple 03:22. Ainsi, tous les sites d’un serveur ne démarrent pas à la même minute.
-
Pour les rythmes de
1hà12h, seule la minute de l’heure compte. Les exécutions se suivent à partir de 0 h à l’intervalle du rythme. -
Avec
5mà30m, les rythmes dewp pro-plan, aucune heure ne compte et il n’y a pas de supplément aléatoire. La commande avertit avec le texte de la boîte de dialogue Attention que ces rythmes ont besoin d’un cron système, et crée le plan malgré tout : Sauvegardes toutes les 5 à 30 minutes. -
Dans la version gratuite, un seul plan s’exécute selon le planning. Si un plan est déjà actif,
resumerefuse un deuxième plan et nomme le plan que tu dois d’abord mettre en pause. Avec cloneworx Backup Pro, tous les plans actifs s’exécutent selon le planning.
Les zones pour --roots
| Valeur | Dans le formulaire | Contenu |
|---|---|---|
db |
Base de données | Les tables de la base de données qui appartiennent à ce site. |
wp-content |
wp-content | Tout ce qui, dans wp-content, n’appartient pas aux extensions, aux thèmes, aux mu-plugins ou aux téléversements. |
wp-core |
Cœur de WordPress | Les dossiers wp-admin et wp-includes et les fichiers que WordPress livre dans le dossier racine. |
wp-mu-plugins |
Extensions incontournables (mu-plugins) | Le dossier des mu-plugins. |
wp-plugins |
Plugins | Le dossier des extensions. |
wp-themes |
Thèmes | Le dossier des thèmes. |
wp-uploads |
Téléversements (uploads) | Le dossier des téléversements. |
wp-root |
Dossier racine | Tout le reste dans le dossier du cœur de WordPress, par exemple .htaccess et robots.txt. Si WordPress se trouve dans son propre sous-dossier avec sa propre adresse, les fichiers de la racine web en font aussi partie. |
Les règles d’exclusion et les tables dont seule la structure est sauvegardée s’appliquent à tout le site et donc à chaque plan. Pour en savoir plus : Définir ce qui est sauvegardé.
Modifier un plan : edit
# Modifier l’heure et désactiver l’instantané wp cloneworx-backup plan edit "Nachts" --time=04:30 --snapshot=no # Choisir une autre destination wp cloneworx-backup plan edit plan-1 --target=local-1
edit accepte les mêmes paramètres que add et en a besoin d’au moins un. Seul ce que tu indiques est modifié. Si tu modifies le rythme, le jour ou l’heure, l’extension recalcule la prochaine exécution. Le supplément aléatoire à l’heure reste le même. Si le plan contient des réglages de cloneworx Backup Pro et que cloneworx Backup Pro est actif avec une licence valide, plan edit ne change rien et nomme wp pro-plan edit. Si cloneworx Backup Pro manque ou si la licence n’est pas valide, plan edit supprime ces réglages du plan et le dit dans un avertissement.
Mettre en pause et activer : pause et resume
# Mettre le plan de sauvegarde en pause wp cloneworx-backup plan pause plan-1 # Activer le plan de sauvegarde wp cloneworx-backup plan resume plan-1
resume indique dans la sortie la prochaine exécution. L’extension la calcule à partir de maintenant : un plan en pause depuis des semaines ne démarre pas à l’instant où tu l’actives. Un plan ne peut être activé qu’avec une destination utilisable, c’est-à-dire une destination dont le dernier test de connexion a réussi.
Un plan actif démarre de lui-même à sa prochaine exécution dès qu’un planificateur sollicite le site. Si aucun planificateur n’arrive dans l’heure qui suit l’horaire prévu, l’exécution est considérée comme manquée : rien ne démarre, et le plan passe à son prochain horaire régulier. Un site sans visiteurs a donc besoin d’un cron système : Planification et cron système avec WP-CLI.
Exécuter un plan immédiatement : run
# Exécuter le plan de sauvegarde maintenant et attendre le résultat wp cloneworx-backup plan run "Sauvegarde quotidienne" # Seulement lancer la sauvegarde ; le site la poursuit wp cloneworx-backup plan run plan-1 --background
run lance immédiatement une sauvegarde avec le contenu et la destination du plan. Cela fonctionne aussi pour un plan en pause : la pause ne concerne que la planification. La sauvegarde compte pour le plan et compte comme sa dernière exécution. Elle ne décale pas la prochaine exécution planifiée. Si le plan contient des réglages de cloneworx Backup Pro, plan run ne lance rien et nomme wp pro-plan run.
| Paramètre | Signification |
|---|---|
--background |
La commande lance la sauvegarde et se termine. Le site la poursuit lui-même ; wp cloneworx-backup job status affiche l’état. |
--force |
Passe outre la vérification de l’utilisateur. |
Sans --background, la commande affiche une ligne de progression par étape : la phase, le nombre d’entrées, la quantité et, dès qu’il peut être estimé, le temps restant. À la fin figure le résultat avec le nombre d’étapes et d’avertissements, puis les détails sur la base de données, les fichiers et le transfert par destination. Après une sauvegarde correcte, la commande mène aussi le post-traitement à son terme : elle supprime les sauvegardes qui dépassent Sauvegardes max. et nettoie les restes sur les destinations.
Si la sauvegarde échoue, la sortie indique les derniers messages de la tâche, l’état par destination et la raison. Si le plan n’a pas de destination utilisable ou qu’une autre tâche est déjà en cours, la commande ne lance rien et le signale.
Supprimer un plan : remove
# Supprimer le plan de sauvegarde ; ses sauvegardes restent wp cloneworx-backup plan remove "Nachts"
La commande ne demande pas de confirmation
Contrairement à la page Sauvegarde, il n’y a ici aucune demande de confirmation : le plan est supprimé immédiatement. Les sauvegardes qu’il a créées restent.
Si tu supprimes tous les plans, l’extension crée de nouveau un premier plan avec la prochaine destination que tu ajoutes.
Si la commande refuse une indication
Si une valeur n’est pas valide, la commande n’enregistre rien. Elle indique le champ avec un code et se termine par Plan settings are not valid.
| Champ | Code | Signification |
|---|---|---|
name |
required, taken, too_long
|
Le nom est vide, appartient déjà à un autre plan ou dépasse 100 caractères. |
rhythm, weekday, monthday, snapshot
|
invalid |
La valeur ne figure pas dans le tableau des valeurs autorisées. |
roots |
required, invalid
|
La liste est vide ou nomme une zone qui n’existe pas. |
targets |
required |
La liste est vide. |
targets |
unknown |
La destination n’existe pas, ou elle est retirée. |
targets |
not_usable |
La destination n’est pas utilisable. Teste d’abord sa connexion. |
retention |
invalid, out_of_range
|
La valeur n’est pas un nombre entier ou n’est pas comprise entre 1 et 99. |
state |
no_usable_target |
Le plan ne peut pas être activé parce qu’il n’a pas de destination utilisable. |
state |
single_plan |
Dans la version gratuite, un autre plan est déjà actif. La commande avertit : Only one plan runs on schedule. Pause the plan "…" first.
|
rhythm |
pro_rhythm |
This rhythm exists only with cloneworx Backup Pro. Choose another rhythm (--rhythm) to switch the plan on. |
retention |
retention_required |
Sauvegardes max. est à 0. Mets --retention sur un nombre de 1 à 99. |
retention |
retention_pro_missing |
Le plan a des paliers de la conservation par ancienneté, mais pas de licence valide. Mets --retention sur un nombre de 1 à 99, puis réactive le plan. |
La commande refuse immédiatement une heure dans une forme incorrecte et indique la forme autorisée.
PROPlusieurs destinations et rythmes courts : wp pro-plan
Cette fonction fait partie de cloneworx Backup Pro : Installation · Commande
# Deux destinations, s3-1 une fois par semaine wp pro-plan add --targets=local-1,s3-1 --rules=s3-1:weekly --rhythm=daily --time=03:15 --name="Nachts" # Régler le rythme sur toutes les 15 minutes wp pro-plan edit "Nachts" --rhythm=15m # Exécuter le plan maintenant wp pro-plan run "Nachts" # Une sauvegarde sans plan vers deux destinations wp pro-backup run --targets=local-1,s3-1
wp pro-plan add et wp pro-plan edit acceptent tous les paramètres de plan add et plan edit. S’y ajoutent --targets avec une ou plusieurs destinations, séparées par des virgules, --rules avec la règle de chaque destination supplémentaire sous la forme <Ziel>:<Regel>, et les rythmes 5m, 10m, 15m et 30m. wp pro-plan run lance un plan tout de suite, avec --background comme pour plan run. wp pro-backup run lance une sauvegarde sans plan vers les destinations de --targets. Les quatre nécessitent une licence valide. Pour en savoir plus : La règle 3-2-1 - l’étalon-or des sauvegardes et Sauvegardes toutes les 5 à 30 minutes.
PROExceptions par plan : wp pro-plan
Cette fonction fait partie de cloneworx Backup Pro : Installation · Commande
La commande wp pro-plan gère les exceptions d’un plan : des règles qui ne s’appliquent qu’à ce plan, en plus des exclusions du site. add et edit ont besoin d’une licence valide : La licence de cloneworx Backup Pro.
# Afficher les exceptions de tous les plans wp pro-plan list # Créer un plan quotidien sans les fichiers JPG des téléversements wp pro-plan add --targets=local-1 --rhythm=daily --time=03:15 --name="Ohne Bilder" --exclusions="wp-uploads/**/*.jpg" # Remplacer les exceptions d’un plan wp pro-plan edit "Ohne Bilder" --exclusions="wp-uploads/**/*.jpg,wp-uploads/**/*.png" # Supprimer les exceptions d’un plan wp pro-plan edit "Ohne Bilder" --exclusions=""
Pour chaque plan, list affiche l’identifiant, le nom, les exceptions et les paliers de la conservation par ancienneté. add et edit acceptent tous les paramètres de plan add et plan edit et en plus --exclusions : les règles, séparées par des virgules, dans les mêmes formes que les exclusions. --exclusions remplace les exceptions du plan ; une valeur vide les supprime. Dans le formulaire du plan : Plans de sauvegarde : tuile et formulaire.
PROConservation par ancienneté : wp pro-plan --age
Cette fonction fait partie de cloneworx Backup Pro : Installation · Commande
# Définir la conservation par ancienneté wp pro-plan edit "Nachts" --age=run:2,daily:7,weekly:4,monthly:12 # Revenir à un nombre fixe wp pro-plan edit "Nachts" --age="" --retention=7
--age accepte les quatre paliers : run en heures, daily en jours, weekly en semaines, monthly en mois. Les paliers non indiqués valent 0 ; une valeur vide les désactive tous. Avec un palier, --retention est à 0. Ce que font les paliers : Conservation par ancienneté.
PROChiffrer les sauvegardes : wp pro-plan --encrypt
Cette fonction fait partie de cloneworx Backup Pro : Installation · Commande
# Activer le chiffrement d’un plan wp pro-plan edit "Nachts" --encrypt=yes # Désactiver le chiffrement d’un plan wp pro-plan edit "Nachts" --encrypt=no
--encrypt=yes nécessite une licence valide. Le plan ne chiffre qu’une fois la clé de récupération configurée. wp pro-plan list indique pour chaque plan si le plan chiffre. En savoir plus : Chiffrer les sauvegardes.