Avec wp cloneworx-backup restore, tu vérifies avant une restauration si elle peut réussir, tu restaures une sauvegarde et tu conserves la restauration ou tu l’annules. Avec wp cloneworx-backup import, tu ajoutes à la liste une sauvegarde issue d’un fichier.
WP-CLI n’est pas encore installé ? Le guide se trouve dans Installer WP-CLI. Toutes les commandes de l’extension sont présentées dans Les commandes en un coup d’œil.
Ce qui vaut pour toutes les actions
- Tu indiques une sauvegarde par le nom de sa tâche.
wp cloneworx-backup backup listl’affiche. Dans les exemples, il est noté<Job>. Une sauvegarde avec le statutsuccessouwarningspeut être restaurée. - Une seule tâche s’exécute à la fois par site. Si une tâche est déjà en cours, chaque commande qui lance une tâche se termine par une erreur et indique la tâche en cours.
- Les sorties sont en anglais. Le délai du retour en arrière y figure en UTC.
- Toutes les actions sauf
restore statusvérifient d’abord l’utilisateur : la commande doit s’exécuter en tant que l’utilisateur à qui appartiennent les dossiers de l’extension. Pourrestore prechecketimport,--forcepasse outre la vérification. Pourrestore run,keepetundo, il n’y a pas de--force: le site ne pourrait plus modifier ensuite les fichiers d’un autre utilisateur.
Vérifier avant la restauration : precheck
restore precheck exécute la vérification préalable : neuf points avant qu’une restauration n’écrive quoi que ce soit. La vérification préalable ne change rien au site. Pour le test des droits, elle crée des dossiers et des tables et les supprime à nouveau.
| Paramètre | Signification | Valeurs autorisées |
|---|---|---|
--target |
La destination sur laquelle l’extension lit la sauvegarde. Sans ce paramètre : la première destination locale où la sauvegarde est complète, sinon la première autre. | Identifiant d’une destination |
--roots |
Ce qui est restauré. Sans ce paramètre : chaque racine de la sauvegarde. | Racines, séparées par des virgules, par exemple db,wp-uploads
|
--include-core |
Restaure le cœur de WordPress aussi sur un autre site. | sans valeur |
--include-dropins |
Restaure object-cache.php, advanced-cache.php et db.php aussi sur un autre site. |
sans valeur |
--include-htaccess |
Restaure .htaccess, web.config et .user.ini aussi sur un autre site. |
sans valeur |
--uploads-in-place |
Choisit pour les téléversements l’option sans retour en arrière, si l’espace à côté du dossier actif ne suffit pas. | sans valeur |
--remove-extras |
Vérifie pour une restauration qui supprime tout ce qui n’est pas dans la sauvegarde : la ligne tables not in the backup indique alors que les tables listées passent dans l’état précédent. La vérification préalable elle-même ne supprime rien. Le nom précédent --remove-extra-uploads reste accepté. |
sans valeur |
--force |
S’exécute aussi en tant qu’un autre utilisateur. | sans valeur |
Les trois paramètres --include n’agissent que si la sauvegarde provient d’un autre site ou si son origine est inconnue. Sur le même site, l’extension restaure par défaut le cœur, les drop-ins et .htaccess.
# Exécuter la vérification préalable pour une sauvegarde wp cloneworx-backup restore precheck <Job> # Lire la sauvegarde sur une destination précise, seulement deux racines wp cloneworx-backup restore precheck <Job> --target=local-1 --roots=db,wp-uploads
Si ce site ne connaît pas la sauvegarde parce qu’elle a été retrouvée sur une destination, importée ou écrite avec une version antérieure de l’extension, restore precheck et restore run se terminent par une erreur. Avec --accept-unknown, tu confirmes la sauvegarde comme correcte : le site retient alors le fichier d’information tel qu’il se trouve sur la destination. Ne confirme la sauvegarde comme correcte que si tu fais confiance à la destination.
La première ligne de la sortie indique la sauvegarde, la destination sur laquelle elle a été lue, les racines et l’origine : le même site, un autre ou inconnue. Suit ensuite une ligne par point avec l’état et le constat.
| État | Signification |
|---|---|
OK |
Le point est en ordre. |
WARN |
Quelque chose que tu devrais savoir. C’est toi qui décides. Un avertissement ne bloque jamais la restauration. |
FAIL |
La restauration ne peut pas démarrer. |
UNKNOWN |
Le point n’a pas pu être déterminé. |
| Point dans la sortie | Dans l’interface |
|---|---|
readable |
Sauvegarde lisible et complète |
versions |
Version de PHP et MySQL |
space |
Espace libre |
permissions |
Droits d’écriture sur les dossiers de destination |
packet |
max_allowed_packet par rapport à la plus grande ligne |
collations |
Collations |
fingerprint |
Même site web |
db_rights |
Droits de base de données (test) |
loopback |
Auto-requête possible |
Sous les points figure ce qui n’est pas restauré et pourquoi. Si la base de données fait partie des racines et que ce site a des tables qui ne sont pas dans la sauvegarde, la ligne tables not in the backup liste ces tables : au plus 50 par leur nom, les autres seulement sous forme de nombre. Entre parenthèses, il est indiqué si elles restent (they stay) ou si elles passent dans l’état précédent avec --remove-extras (they move to the previous state). Les tables d’une autre installation WordPress qui se trouvent dans la même base de données sous un préfixe plus long ne figurent pas dans la ligne. Enfin, la sortie liste les différences entre la sauvegarde et ce site : par ligne, la valeur dans la sauvegarde et la valeur ici. Tu vérifies toi-même le risque de ces différences. Si un point a l’état FAIL, la commande se termine par une erreur. Chaque point est expliqué dans La vérification préalable de la restauration : chaque point expliqué.
Restaurer une sauvegarde : run
Une restauration remplace l’état du site
La sauvegarde remplace l’état actuel des racines choisies. L’état précédent est conservé 7 jours ; pendant ce temps, tu peux annuler la restauration. Font exception les téléversements remplacés sur place avec --uploads-in-place : pour eux, il n’y a pas de retour en arrière.
restore run restaure les racines choisies. Cela se passe ainsi :
- La vérification préalable s’exécute comme première phase. Un
FAILtermine la tâche avant que quoi que ce soit ne soit écrit. - L’extension prépare les fichiers à côté des dossiers actifs et importe la base de données dans des tables à côté des tables actives. Le site continue de fonctionner pendant ce temps.
- L’extension bascule les téléversements et les fichiers du dossier racine fichier par fichier, sans mode maintenance.
- L’extension bascule la base de données, le cœur, les mu-plugins, les extensions, les thèmes et le reste de
wp-contentdans le mode maintenance de WordPress. Cette étape s’exécute dans le serveur web : la commande la confie via l’auto-requête et attend. - Le nouveau site se confirme lui-même. Si la confirmation n’arrive pas dans les 60 secondes, la même étape rebascule, et le site fonctionne de nouveau dans l’état précédent.
Si l’auto-requête n’arrive pas au serveur web dans les 60 secondes, la commande interrompt la restauration avant le basculement. L’extension reprend ce qui avait été basculé jusque-là, et le site continue de fonctionner dans son état précédent. Seuls les téléversements remplacés sur place avec --uploads-in-place restent remplacés.
L’extension elle-même, avec ses dossiers et ses tables, et wp-config.php ne sont jamais restaurés. Les fichiers des téléversements et du dossier racine qui ne sont pas dans la sauvegarde restent en place par défaut. Les tables de ce site qui ne sont pas dans la sauvegarde restent par défaut ; le résultat les indique. Avec --remove-extras, ces fichiers et ces tables passent dans l’état précédent.
| Paramètre | Signification | Valeurs autorisées |
|---|---|---|
--target, --roots, --include-core, --include-dropins, --include-htaccess, --uploads-in-place
|
Comme pour restore precheck. |
comme ci-dessus |
--remove-extras |
Supprime, dans les racines choisies, tout ce qui n’est pas dans la sauvegarde : les fichiers des téléversements et du dossier racine et, avec la racine db, les tables de ce site. Rien n’est effacé tout de suite : les fichiers et les tables passent dans l’état précédent. restore undo les ramène, restore keep les efface définitivement. Par défaut, ils restent. Si la restauration remplace les téléversements sur place avec --uploads-in-place, le paramètre n’a pas d’effet. Le nom précédent --remove-extra-uploads reste accepté ; il a maintenant le même effet et ne s’applique plus seulement aux téléversements. |
sans valeur |
--accept-damaged |
Restaure aussi une sauvegarde avec des entrées endommagées et omet précisément ces entrées. Sans ce paramètre, la restauration se termine avant que quoi que ce soit ne soit basculé et indique le nombre d’entrées endommagées. | sans valeur |
--accept-failed |
Restaure aussi une sauvegarde dont des entrées n’ont pas pu être créées dans le dossier de préparation (pas de place, pas de droits, conflit de noms) et omet précisément ces entrées. Sans ce paramètre, la restauration se termine avant que quoi que ce soit ne soit basculé. | sans valeur |
--without-confirmation |
Bascule dans ce processus, sans la confirmation du nouveau site. Pour les serveurs où l’auto-requête ne fonctionne pas. | sans valeur |
--background |
La commande ne fait que lancer la restauration. Le site la poursuit lui-même. | sans valeur |
# Restaurer la sauvegarde entière wp cloneworx-backup restore run <Job> # Restaurer seulement la base de données wp cloneworx-backup restore run <Job> --roots=db # Restaurer seulement les plugins et les thèmes wp cloneworx-backup restore run <Job> --roots=wp-plugins,wp-themes
La commande écrit une ligne de progression par étape. Pendant que le serveur web bascule, la commande signale toutes les dix secondes qu’elle attend. À la fin figure le résultat : la sauvegarde et la destination, les racines, le nombre d’entrées écrites, les fichiers hors de la sauvegarde, la comparaison du wp-config.php avec la sauvegarde, la base de données avec tables et lignes, la durée du basculement, le mode de confirmation et la réponse de la page d’accueil. La dernière ligne indique le nombre d’avertissements et le moment jusqu’auquel l’état précédent est conservé.
Ces lignes du résultat indiquent ce qui n’était pas dans la sauvegarde et ce que donne la comparaison du wp-config.php :
| Ligne dans le résultat | Signification |
|---|---|
wp-uploads: … files not in the backup, wp-root: … files not in the backup
|
Le nombre de fichiers de cette racine qui ne sont pas dans la sauvegarde ; entre parenthèses, il est indiqué combien d’entre eux sont exécutables. La ligne se termine par they stay ou, avec --remove-extras, par … moved to the previous state : c’est le nombre de fichiers passés dans l’état précédent. Si des fichiers n’ont pas pu être déplacés, … could not be moved and stay suit. |
wp-config.php: |
La comparaison du wp-config.php de ce site avec la sauvegarde. Une sauvegarde ne contient jamais ce fichier ; la ligne indique donc not in the backup, nothing to compare. |
tables not in the backup stay: |
Les tables de ce site qui ne sont pas dans la sauvegarde. Ces tables restent en place. |
tables not in the backup moved to the previous state (undo brings them back): |
Avec --remove-extras : ces tables sont passées dans l’état précédent. |
could not be created:, name conflicts:, symlinks pointing outside:, damaged:
|
Les noms des entrées qui n’ont pas pu être créées, qui ont rencontré un conflit de noms, qui pointent vers l’extérieur en tant que lien symbolique ou qui sont endommagées, jusqu’à dix pour chaque cas. |
…: … excluded entries inside swapped folders stay in place |
Le nombre d’entrées exclues de la sauvegarde qui sont restées en place à l’intérieur de dossiers basculés. |
La restauration ne remet jamais en place le wp-config.php ; il reste tel qu’il est.
Après une restauration de la base de données, ta session dans l’administration de WordPress peut être invalide. Reconnecte-toi alors.
Tant que le retour en arrière d’une restauration est ouvert, aucune nouvelle restauration ne démarre. Conserve d’abord la restauration ouverte ou annule-la.
Afficher l’état d’une restauration : status
restore status affiche la restauration en cours. S’il n’y en a aucune, la commande affiche la restauration dont le retour en arrière est ouvert. Avec le nom de tâche d’une restauration, elle affiche précisément celle-ci. L’action n’a pas de paramètres.
# Afficher la restauration en cours ou le retour en arrière ouvert wp cloneworx-backup restore status
Pour une restauration en cours, la sortie indique la phase et la progression. Pour une restauration terminée, elle indique le statut, le retour en arrière avec son délai et le résultat comme après restore run.
Conserver ou annuler la restauration : keep, undo
| Action | Objectif |
|---|---|
restore keep |
Conserve la restauration : l’extension supprime l’état précédent, les anciens dossiers et les anciennes tables. En fait partie ce que --remove-extras a fait passer dans l’état précédent : ces fichiers et ces tables sont alors définitivement effacés. Ensuite, il n’y a plus de retour en arrière. |
restore undo |
Annule la restauration : l’extension ramène l’état précédent, y compris les fichiers et les tables que --remove-extras a fait passer dans l’état précédent. Les téléversements remplacés sur place restent tels que la restauration les a écrits. Si la conservation a déjà commencé, restore undo refuse. |
Sans nom de tâche, les deux actions utilisent la restauration dont le retour en arrière est ouvert. Avec --background, la commande ne fait que lancer, et le site poursuit la tâche lui-même.
# Conserver la restauration wp cloneworx-backup restore keep # Annuler la restauration wp cloneworx-backup restore undo
La sortie indique combien d’entrées ont été supprimées et combien de tables ont été supprimées ou remises en place. Si tu ne décides rien, l’extension conserve la restauration d’elle-même après 7 jours. Pour en savoir plus : Conserver ou annuler une restauration.
Si l’administration de WordPress est inaccessible
Pour une restauration depuis la ligne de commande, tu n’as besoin ni de te connecter à l’administration de WordPress ni d’un navigateur. Tu as besoin de l’accès au serveur et de WP-CLI. Les commandes sont disponibles tant que WP-CLI peut charger WordPress avec l’extension.
- Cherche la sauvegarde :
wp cloneworx-backup backup list. - Exécute la vérification préalable et lis la ligne
loopback. AvecOK, l’auto-requête arrive. AvecWARN, elle n’arrive pas : la restauration ne fonctionne alors qu’avec--without-confirmation. AvecUNKNOWN, l’extension n’a pas encore testé l’auto-requête sur ce serveur. - Lance la restauration avec
restore run. Si l’auto-requête arrive, la restauration se déroule comme décrit ci-dessus. - Si la restauration s’interrompt parce que l’auto-requête n’arrive pas, le site continue de fonctionner dans son état précédent. Relance alors la restauration, avec
--without-confirmation. - Vérifie le site. Si quelque chose ne va pas,
restore undoramène l’état précédent.
# Étape 1 : chercher la sauvegarde wp cloneworx-backup backup list # Étape 2 : la vérification préalable wp cloneworx-backup restore precheck <Job> # Étape 3 : la restauration wp cloneworx-backup restore run <Job> # Étape 4 : basculer dans ce processus wp cloneworx-backup restore run <Job> --without-confirmation # Étape 5 : si nécessaire, ramener l’état précédent wp cloneworx-backup restore undo
Sans confirmation, c’est toi qui vérifies
Avec --without-confirmation, le nouveau site ne se confirme pas lui-même. S’il ne démarre pas, l’extension ne rebascule pas d’elle-même. L’OPcache du serveur web n’est pas vidé : le serveur peut encore livrer l’ancien code pendant un certain temps. Vérifie toi-même le site après la restauration.
Importer une sauvegarde depuis un fichier : import
import accepte un fichier de sauvegarde qui se trouve sur ce serveur : le fichier tar issu du téléchargement d’une sauvegarde. L’extension lit le fichier par parties, vérifie chaque partie de la sauvegarde par rapport à sa somme de contrôle et stocke la sauvegarde sur la destination que tu indiques. Ensuite, la sauvegarde figure dans la liste, sous le nom de tâche de la sauvegarde d’origine. Comme date, backup list indique le moment de l’import.
| Indication | Signification | Valeurs autorisées |
|---|---|---|
<Datei> |
Le fichier de sauvegarde. Obligatoire. L’indication figure directement après import. |
Chemin d’un fichier tar sur ce serveur |
--target |
La destination sur laquelle la sauvegarde est stockée. Obligatoire. | Identifiant d’une destination utilisable |
--background |
La commande lit le fichier et ne fait que lancer l’import. Le site poursuit la tâche lui-même. | sans valeur |
--max-per-step |
Termine chaque étape de la vérification après ce nombre de parties. Ce paramètre sert au diagnostic. | nombre entier |
--force |
S’exécute aussi en tant qu’un autre utilisateur. | sans valeur |
# Importer un fichier de sauvegarde vers la destination local-1 wp cloneworx-backup import /tmp/backup.tar --target=local-1
La commande n’importe une sauvegarde que ce site ne connaît pas qu’avec --accept-unknown.
La commande indique d’abord la taille lue et le nom de tâche de la sauvegarde contenue dans le fichier, puis la progression de l’import. À la fin figure quand et sur quel site la sauvegarde a été créée, sur quelle destination elle se trouve maintenant, combien de parties ont été vérifiées et quelles racines elle contient.
La commande se termine par une erreur
- si le fichier n’est pas un fichier de sauvegarde de cette extension ou s’il est incomplet,
- si une partie ne correspond pas à sa somme de contrôle : rien n’est alors stocké,
- si la même sauvegarde se trouve déjà sur cette destination,
- s’il existe dans la liste une autre sauvegarde portant le même nom,
- si l’espace pour le fichier manque dans le dossier de travail,
- si le fichier dépasse 32 GiB.
Si la même sauvegarde ne se trouvait jusqu’ici que sur une autre destination, son entrée dans la liste reçoit la nouvelle destination en plus.
Une sauvegarde que l’import inscrit comme nouvelle entrée dans la liste reste jusqu’à ce que tu la supprimes
Une sauvegarde que l’import inscrit comme nouvelle entrée dans la liste a le plan import. L’extension ne la supprime jamais automatiquement. Elle ne compte pas pour l’avertissement sur les sauvegardes en retard. Si une entrée existante reçoit seulement la nouvelle destination en plus, elle garde son plan : si backup list y indique l’identifiant d’un plan de sauvegarde ou manual, la sauvegarde compte aussi sur la nouvelle destination pour Sauvegardes max., et l’extension peut l’y supprimer automatiquement.