La vérification préalable de la restauration : chaque point expliqué

Avant qu’une restauration n’écrive quoi que ce soit, l’extension vérifie neuf points. Voici ce que chaque point vérifie, ce que signifie son constat et ce que tu peux faire en cas d’avertissement ou de blocage.

La vérification préalable se trouve dans la tuile Préparer la restauration sur la page Restauration. Tu ouvres la tuile avec Restaurer la dernière sauvegarde ou, dans le menu d’une sauvegarde, avec Restauration.

Quand la vérification préalable s’exécute

• D’elle-même à l’ouverture : la vérification préalable démarre dès que la tuile Préparer la restauration s’ouvre.
• Après chaque modification : si tu modifies l’étendue, un interrupteur ou la vue, la vérification préalable s’exécute à nouveau peu après. C’est toujours le résultat de la vérification préalable la plus récente qui compte.
• À la main : Lancer la vérification préalable répète la vérification préalable.
• Dans la restauration elle-même : la première étape de chaque restauration est la même vérification préalable. Si un point y bloque, la restauration se termine avant que quelque chose ne soit écrit.

La vérification préalable n’écrit rien sur le site. Pour deux points, l’extension crée à titre de test des dossiers, un fichier et des tables, et les supprime aussitôt.

1. L’indication figure à la place des interrupteurs jusqu’à ce que la première vérification préalable ait répondu : la vérification préalable fixe les valeurs par défaut des interrupteurs. Seule la vue Étendu la montre.
2. Lancer la vérification préalable montre un symbole d’attente tant que la vérification préalable est en cours.
3. Tant qu’aucun résultat n’est là, chaque point montre un anneau qui tourne et vérification …
4. Lancer la restauration est bloqué jusqu’à ce que la vérification préalable soit réussie.

Lire le résultat

1. La ligne indique la durée de la vérification préalable et la destination depuis laquelle la sauvegarde est lue. La destination y figure avec son identifiant, par exemple « local-1 ».
2. Chaque point de la vérification préalable a un point coloré, son nom, l’état et le constat.
3. Non restauré : indique ce que la restauration omet, et pourquoi.
4. Lancer la restauration est libre : aucun point ne bloque le démarrage.

Chaque point se termine par l’un de quatre états. Derrière l’état figure le constat en toutes lettres.

État	Signification	Démarrage possible
vert OK	Le point est en ordre.	oui
jaune Avertissement	Quelque chose que tu devrais savoir. Tu juges le risque et tu décides.	oui
rouge Bloqué	Ainsi, la restauration ne peut pas démarrer.	non
gris Non vérifié	Le point n’a pas pu être établi.	oui

Les neuf points

1. Sauvegarde lisible et complète

L’extension lit la sauvegarde sur une destination où elle se trouve complète. Un dossier local a la priorité. Est vérifié : chaque fichier de la sauvegarde se trouve sur la destination, le fichier d’information est valide, et chaque partie a la taille indiquée dans le fichier d’information. C’est la vérification courte. Chaque bloc de la sauvegarde est lu par Vérifier la sauvegarde sur la page Sauvegarde : Vérifier une sauvegarde.

Constat	Signification	Ce que tu peux faire
OK lu sur place sur une destination locale	La sauvegarde se trouve dans un dossier local. La restauration la lit là.	Rien.
OK lu via le dossier de travail	La sauvegarde se trouve sur une destination distante. La restauration la récupère partie par partie dans le dossier de travail de l’extension.	Rien.
Bloqué fichiers manquants sur la destination : …	Les fichiers nommés de la sauvegarde ne se trouvent plus sur la destination.	Restaure une autre sauvegarde. Si la même sauvegarde se trouve encore sur une deuxième destination, la ligne de commande la lit de là avec --target.
Bloqué fichiers d’une autre taille sur la destination : …	Les fichiers nommés n’ont pas la taille que la sauvegarde consigne.	Comme à la ligne précédente. Vérifier la sauvegarde lit la sauvegarde en entier et la marque dans la liste. Si elle échoue sur cette destination, la prochaine vérification préalable lit depuis une autre destination où elle se trouve complète.
Bloqué aucune copie complète sur aucune destination	La liste des sauvegardes ne connaît aucun fichier de la sauvegarde sur cette destination.	Restaure une autre sauvegarde.
Bloqué le fichier d’information manque ou est illisible	Le fichier d’information décrit ce que contient la sauvegarde. Sans lui, la sauvegarde ne peut pas être lue.	Restaure une autre sauvegarde.
Bloqué un code en anglais au lieu d’une phrase	La destination n’a pas répondu, ou le fichier d’information n’a pas pu être récupéré ou lu. Pour ces cas, la page n’a pas de phrase propre.	Teste la destination sur la page Destinations : Plus …, puis Tester la connexion. Relance ensuite la vérification préalable.

Si la sauvegarde ne peut pas être lue, les points 2 à 8 restent non vérifiés. On y lit alors Non vérifié. Pour le constat, la page n’a pas de phrase propre à ces points : on y lit une abréviation en anglais. Sous les points figure alors aussi l’indication relative à un autre site, que décrit le point 7.

1. Le point Sauvegarde lisible et complète a un point rouge et bloque le démarrage : des fichiers de la sauvegarde manquent sur la destination.
2. Les points 2 à 8 ont un point gris et ne sont pas vérifiés, parce que la sauvegarde n’a pas pu être lue. Le chiffre se trouve sur celui du milieu. Le dernier point, Auto-requête possible, l’extension le vérifie indépendamment.
3. La vérification préalable bloque le démarrage.
4. Lancer la restauration est bloqué.

2. Version de PHP et MySQL

L’extension compare ce site avec les valeurs avec lesquelles la sauvegarde a été créée : PHP, type et version du serveur de base de données, jeu de caractères de la base de données, version de WordPress, préfixe des tables et Multisite. Une sauvegarde issue d’une version plus ancienne de l’extension compte aussi comme différence. Pour PHP et pour le serveur de base de données, les deux premiers chiffres de la version comptent : 8.3 et 8.4 sont différents, 8.4.1 et 8.4.5 ne le sont pas. Le point ne bloque jamais.

Constat	Signification	Ce que tu peux faire
OK mêmes versions que la sauvegarde	Rien ne diffère.	Rien.
Avertissement … différence(s), listées ci-dessous	Sous les points figure la liste des différences, une par ligne.	Lis la liste et vérifie toi-même le risque, par exemple si tes extensions et ton thème fonctionnent avec la version de PHP de ce site.

3. Espace libre

La restauration prépare les fichiers à côté des dossiers actifs. Pour cela, chaque racine, par exemple les extensions ou les téléversements, a besoin d’autant d’espace que la taille de ses fichiers dans la sauvegarde, plus un petit supplément par fichier. Voici comment l’extension calcule :

• Les dossiers sur le même support de stockage comptent ensemble.
• Une réserve reste toujours libre : 256 MiB ou 2 % du support de stockage, selon ce qui est le plus grand.
• Le dossier de travail de l’extension a besoin d’espace pour deux parties de la sauvegarde. Si la base de données fait partie de l’étendue, la taille de ses données s’y ajoute.
• L’extension ne peut pas mesurer l’espace libre du serveur de base de données.

Constat	Signification	Ce que tu peux faire
OK assez d’espace partout	L’espace suffit à chaque endroit.	Rien.
Non vérifié l’espace libre n’a pas pu être mesuré partout	Le serveur n’indique pas l’espace libre pour chaque endroit. Le démarrage reste possible.	Vérifie l’espace libre chez ton hébergeur avant de démarrer.
Bloqué pas assez d’espace pour construire les téléversements à côté du dossier actif	Pour tout le reste, l’espace suffit, pas pour les téléversements. Sous les points apparaît le bloc Pas de retour en arrière.	Libère de l’espace, ou choisis expressément la voie sans retour en arrière : Restaurer les uploads quand l’espace ne suffit pas.
Avertissement les téléversements seront remplacés sur place (sans retour)	Tu as activé la voie sans retour en arrière. Le démarrage est libre.	Décoche à nouveau la case si tu ne veux pas de cette voie.
Bloqué pas assez d’espace pour le cœur et le code	À au moins un endroit, l’espace ne suffit pas, même sans compter les téléversements. Cela peut aussi être le dossier de travail de l’extension.	Libère de l’espace sur le support de stockage, ou choisis dans la vue Étendu une étendue plus petite. La vérification préalable en ligne de commande indique l’espace par endroit.
Bloqué un dossier racine est inconnu	L’étendue comprend une racine dont l’extension ne peut pas déterminer le dossier sur ce site.	Retire cette racine de l’étendue dans la vue Étendu. La page ne la nomme pas : décoche les cases une à une jusqu’à ce que le point ne bloque plus.

Voici à quoi ressemble la vérification préalable quand le serveur n’indique pas l’espace libre :

1. Le point Espace libre a un point gris. Suivent le nom, l’état Non vérifié et le constat l’espace libre n’a pas pu être mesuré partout.
2. Lancer la restauration est libre : un point non vérifié ne bloque pas le démarrage.

4. Droits d’écriture sur les dossiers cibles

Il s’agit des dossiers du site dans lesquels la restauration écrit, pas des destinations des sauvegardes. Dans chaque dossier racine choisi, l’extension crée à titre de test son dossier de préparation et le supprime. Pour cela, le dossier racine de WordPress doit être accessible en écriture, même si le cœur ne fait pas partie de l’étendue : c’est là que se trouve, pendant le basculement, le fichier du mode maintenance. Si un dossier racine manque sur ce site, par exemple le dossier des extensions incontournables, la restauration le crée. Pour cela, le dossier au-dessus doit être accessible en écriture.

Constat	Signification	Ce que tu peux faire
OK accessible en écriture	L’extension peut écrire dans chaque dossier.	Rien.
Bloqué un dossier racine n’est pas accessible en écriture	Dans au moins un dossier racine, l’extension n’a pas pu créer son dossier, ou un dossier racine manquant ne peut pas être créé.	Donne au serveur web les droits d’écriture sur ce dossier. La vérification préalable en ligne de commande indique lequel.
Bloqué le dossier racine de WordPress n’est pas accessible en écriture	Dans le dossier racine de l’installation, l’extension n’a pas pu créer de fichier.	Donne au serveur web les droits d’écriture sur le dossier racine de WordPress.
Bloqué l’extension n’a pas encore de code de dossier	Les dossiers de l’extension portent un code dans leur nom. L’extension n’a pas pu créer ou enregistrer ce code.	Demande de l’aide : Obtenir de l’aide : rapport de support, dépannage et diagnostic.

5. max_allowed_packet par rapport à la plus grande ligne

max_allowed_packet est un réglage du serveur de base de données : c’est la taille maximale d’une instruction. La sauvegarde consigne sa plus grande ligne. Cette ligne doit tenir dans la limite avec une réserve de 4096 octets.

Constat	Signification	Ce que tu peux faire
OK la plus grande ligne tient dans max_allowed_packet	Chaque ligne de la sauvegarde peut être insérée.	Rien.
Bloqué une ligne dépasse max_allowed_packet	Le serveur de base de données de ce site n’accepterait pas la plus grande ligne de la sauvegarde. L’extension ne peut pas restaurer une telle ligne.	La valeur est modifiée par la personne qui administre le serveur de base de données, le plus souvent ton hébergeur. Sans la base de données, le reste peut être restauré : décoche dans la vue Étendu la case Base de données.
Non vérifié n’a pas pu être lu depuis le serveur de base de données	Le serveur de base de données n’a pas indiqué la valeur. Le démarrage reste possible.	Relance la vérification préalable.
Bloqué le serveur de base de données était injoignable	La vérification préalable n’a pas pu se connecter à la base de données. Le même constat figure alors aussi aux points 6 et 8.	Relance la vérification préalable.

6. Collations

Une collation définit comment la base de données compare et trie le texte. L’extension compare les jeux de caractères et les collations de toutes les tables et colonnes de la sauvegarde avec ceux que connaît le serveur de base de données de ce site. utf8 et utf8mb3 sont considérés comme identiques. Le point ne bloque que si le serveur de base de données est injoignable.

Constat	Signification	Ce que tu peux faire
OK tous les jeux de caractères et collations sont connus ici	Rien ne doit être remplacé.	Rien.
Avertissement … remplacées, listées ci-dessous	Le serveur de base de données ne connaît pas tout ce que la sauvegarde utilise. Sous les points figure ce que l’import remplace, et par quoi.	Vérifie toi-même le risque. Une collation remplacée peut changer le tri et la recherche. Si elle considère comme identiques deux valeurs qui étaient différentes auparavant, l’import s’arrête sur une clé en double avant que quelque chose ne soit basculé.
Non vérifié non consignées dans cette sauvegarde (ancienne version de l’extension) ; l’import les vérifie	La sauvegarde provient d’une version plus ancienne de l’extension et ne porte pas encore la liste.	Rien. L’import vérifie quand il crée les tables.
Non vérifié n’a pas pu être lu depuis le serveur de base de données	Le serveur de base de données n’a pas indiqué ses collations.	Relance la vérification préalable.
Bloqué le serveur de base de données était injoignable	Voir le point 5.	Relance la vérification préalable.

Voici comment l’extension choisit le remplacement : une collation qui distingue les majuscules des minuscules ou qui compare en binaire devient la collation binaire de son jeu de caractères. Toute autre devient la collation par défaut de son jeu de caractères sur ce serveur. Si le jeu de caractères lui-même manque, c’est le jeu de caractères de la connexion qui compte.

7. Même site web

Une sauvegarde porte une empreinte composée de l’adresse du site et de son chemin sur le serveur. L’extension la compare avec cette installation. Le point ne bloque jamais, mais il change les valeurs par défaut des interrupteurs.

Constat	Signification	Ce que tu peux faire
OK ce site	La sauvegarde provient de cette installation. Par défaut, le cœur de WordPress, les drop-ins et les fichiers .htaccess, web.config et .user.ini font aussi partie de la restauration.	Rien.
Avertissement un autre site	La sauvegarde provient d’un autre site ou d’un autre chemin. Par défaut, le cœur de WordPress, les drop-ins et les fichiers .htaccess, web.config et .user.ini restent de côté.	Ce que tu veux quand même restaurer, tu l’actives dans la vue Étendu : Restaurer une sauvegarde sur un autre site.
Avertissement origine inconnue (pas d’empreinte) ; traitée comme un autre site	La sauvegarde ne porte pas d’empreinte. Les valeurs par défaut d’un autre site s’appliquent. Elle n’est jamais refusée.	Comme à la ligne précédente.

Pour les deux avertissements, on lit sous les points Site différent : cette sauvegarde a été faite sur un autre site. L’adresse du site reste celle de ce site.

8. Droits de base de données (test)

L’extension ne lit aucune liste de droits. Elle fait sur des tables jetables ce que la restauration fera : créer, insérer, créer un index, une deuxième table avec clé étrangère, un déclencheur, une vue, renommer, supprimer. Ensuite, elle supprime tout, même après une erreur.

Constat	Signification	Ce que tu peux faire
OK création, insertion, index, renommage, suppression, clé étrangère, déclencheur et vue fonctionnent	L’utilisateur de la base de données a tous les droits dont la restauration a besoin.	Rien.
Avertissement clé étrangère, déclencheur ou vue refusés ; l’import les omet	Les tables et les données peuvent être restaurées. L’import ne crée pas les clés étrangères, déclencheurs ou vues et le dit dans le résultat.	Vérifie si ton site a besoin de ces objets. Les droits sont attribués par la personne qui administre la base de données, le plus souvent ton hébergeur.
Bloqué création, insertion, index, renommage ou suppression refusés	Il manque à l’utilisateur de la base de données un droit sans lequel la restauration est impossible.	Demande ce droit à ton hébergeur. La vérification préalable en ligne de commande indique à quelle étape le test a échoué, avec le message du serveur de base de données.
Bloqué le serveur de base de données était injoignable	Voir le point 5.	Relance la vérification préalable.

9. Auto-requête possible

Après le basculement, le nouveau site doit se confirmer. Ce point dit par quelle voie cela se passe : via l’auto-requête, avec laquelle le serveur appelle sa propre adresse, ou via la page ouverte dans le navigateur. Le point ne bloque jamais.

Constat	Signification	Ce que tu peux faire
OK l’auto-requête fonctionne ; le nouveau site se confirme lui-même	Le serveur s’atteint lui-même.	Rien.
Avertissement pas d’auto-requête : laisse cette page ouverte jusqu’à la confirmation de la restauration	Les auto-requêtes n’arrivent pas sur ce serveur. La page Restauration ouverte confirme le nouveau site à sa place.	Laisse la page ouverte jusqu’à ce que la restauration soit terminée. Sans confirmation, l’extension rebascule tout après 60 secondes.
Non vérifié pas encore testée	Aucune auto-requête n’a encore eu lieu sur ce site. Le démarrage reste possible.	Laisse la page ouverte. Vérifier les sources de tâches sur la page Réglages, dans la vue Étendu, dans la tuile Planificateur, établit si les auto-requêtes arrivent.

Si la base de données ne fait pas partie de l’étendue

Si tu décoches dans la vue Étendu la case Base de données, les points 5, 6 et 8 disparaissent. Tous trois sont alors sur OK, sans que rien n’ait été vérifié. Pour le constat, la page n’a pas de phrase propre : on y lit une abréviation en anglais indiquant que la base de données n’est pas choisie. Dans la liste des différences manquent alors le préfixe des tables, la version de l’extension et les informations sur le serveur de base de données.

1. Base de données n’est pas cochée : la base de données n’est pas restaurée.
2. Le point max_allowed_packet par rapport à la plus grande ligne est vert, sans vérification : la base de données n’est pas choisie.
3. Il en va de même pour le point Collations.
4. Il en va de même pour le point Droits de base de données (test).

Ce qui figure sous les points

1. Un point avec avertissement a un point jaune ; l’état et le constat sont en jaune.
2. La liste indique les différences entre la sauvegarde et ce site, une par ligne.
3. Remplacé à l’import (inconnu de ce serveur de base de données) : indique sur chaque ligne une collation de la sauvegarde et son remplacement.
4. Non restauré : indique ce que la restauration omet, et pourquoi.
5. L’indication dit que la sauvegarde provient d’un autre site et que l’adresse de ce site est conservée.
6. Lancer la restauration reste libre : les avertissements ne bloquent pas le démarrage.

Différences

Au-dessus de la liste, on lit Différences entre la sauvegarde et ce site. Tu juges le risque ; la restauration suit la meilleure voie possible : Chaque ligne a la forme … : sauvegarde …, ici …

Ligne	Ce qui est comparé
PHP	La version de PHP, deux premiers chiffres.
WordPress	La version de WordPress.
Préfixe des tables	Le préfixe des tables. L’import convertit les tables de la sauvegarde au préfixe de ce site.
Multisite	La ligne apparaît si la sauvegarde ou ce site est un Multisite. Multisite n’est pas pris en charge : la sauvegarde ne contient que les tables du site principal. Les valeurs sont en anglais : yes ou no.
Version de l’extension	La sauvegarde provient d’une version plus ancienne de l’extension. Il peut y manquer des colonnes dont la valeur par défaut est une expression ; l’import les nomme, et elles reçoivent leur valeur par défaut.
Base de données	Le type du serveur de base de données : MySQL ou MariaDB.
Version de la base de données	La version du serveur de base de données, deux premiers chiffres.
Jeu de caractères de la base de données	Le jeu de caractères du serveur de base de données.

Si le serveur de base de données ne connaît pas un jeu de caractères ou une collation de la sauvegarde, cela figure aussi dans la liste. Ces lignes commencent par le mot anglais charset ou collation.

Remplacé à l’import

La liste apparaît quand l’import doit remplacer une collation. Le point Collations avertit alors. Chaque ligne indique à gauche la collation de la sauvegarde et à droite, derrière la flèche, le remplacement que prend l’import. La liste indique au plus 50 entrées.

Non restauré

La ligne indique chaque racine et chaque fichier que la restauration omet, avec la raison entre parenthèses.

Raison	Signification
jamais restauré	Vaut pour cette extension avec ses dossiers et ses tables, et pour le fichier wp-config.php. Le fichier est contenu dans la sauvegarde, mais n’est jamais réécrit. Dans la ligne, il figure comme « wp-config ».
absent de la sauvegarde	La racine choisie n’est pas contenue dans cette sauvegarde.
cœur de WordPress non choisi	L’interrupteur Ne pas restaurer le cœur de WordPress est coché.
omis selon ton choix	Tu as désélectionné les drop-ins ou les fichiers .htaccess, web.config et .user.ini.
omis par défaut sur un autre site	La sauvegarde provient d’un autre site. Les drop-ins et les fichiers .htaccess, web.config et .user.ini restent de côté tant que tu ne les actives pas.

Si un point bloque

1. Le point qui bloque a un point rouge ; l’état et le constat sont en rouge.
2. La vérification préalable bloque le démarrage.
3. Lancer la restauration est bloqué.

Corrige la cause et clique sur Lancer la vérification préalable. Si plus aucun point ne bloque, Lancer la restauration est libre.

Pas de retour en arrière : les téléversements ne tiennent pas à côté

1. Le point Espace libre bloque le démarrage.
2. Pas de retour en arrière est le titre du bloc, précédé d’un triangle d’avertissement. En dessous figure ce qui est irréversible.
3. Remplacer quand même les téléversements sur place (irréversible) est le choix de cette voie. La case est vide par défaut.
4. La vérification préalable bloque le démarrage.
5. Lancer la restauration est bloqué tant que ce choix n’est pas coché.

Si la vérification préalable n’aboutit pas

1. L’indication figure à la place des interrupteurs : les valeurs par défaut ne sont pas encore fixées. Seule la vue Étendu la montre.
2. Lancer la vérification préalable relance la vérification préalable.
3. Le message du serveur indique la cause, en rouge.
4. pas encore vérifié figure sur chaque point.

Message	Ce que tu peux faire
Cette sauvegarde n’est complète sur aucune destination.	La sauvegarde ne se trouve plus complète sur aucune destination configurée, par exemple parce que la destination a été retirée. Restaure une autre sauvegarde.
Cette sauvegarde n’existe pas.	La liste ne connaît plus la sauvegarde. Recharge la page et choisis une sauvegarde dans la liste.
un autre message	Clique sur Lancer la vérification préalable.

Voir aussi

• La page « Restauration »
• Restaurer le site à partir d’une sauvegarde
• Ne restaurer que des parties
• Restaurer une sauvegarde sur un autre site
• Restaurer et importer avec WP-CLI

En ligne de commande

WP-CLI n’est pas encore installé ? Voici comment installer WP-CLI.

La vérification préalable fonctionne aussi avec WP-CLI et n’écrit alors rien sur le site. La sortie est en anglais : une ligne par point avec l’état et le constat, puis ce qui n’est pas restauré, puis les différences. La sortie indique des détails que la page ne montre pas : le dossier racine sans droit d’écriture, l’espace par endroit, la table avec la plus grande ligne et l’étape à laquelle le test des droits de base de données a échoué. Si un point bloque, la commande se termine par une erreur.

# Afficher les sauvegardes avec leur nom de tâche
wp cloneworx-backup backup list

# Exécuter la vérification préalable pour une sauvegarde
wp cloneworx-backup restore precheck <Job>

# Lire la sauvegarde depuis une destination précise
wp cloneworx-backup restore precheck <Job> --target=local-1

# Vérifier seulement la base de données et les téléversements
wp cloneworx-backup restore precheck <Job> --roots=db,wp-uploads

# Inclure ce qu’un autre site omet par défaut
wp cloneworx-backup restore precheck <Job> --include-core --include-dropins --include-htaccess

# Choisir la voie sans retour en arrière pour les téléversements
wp cloneworx-backup restore precheck <Job> --uploads-in-place