Sauvegarde et restauration de la boutique Pro – sauvegardes automatiques PrestaShop avec restauration depuis le panneau et sans

À quoi sert le module

• Protection dès la première minute. L’installation crée le profil « Sauvegarde complète quotidienne » : fichiers et base de données chaque nuit à 03:00, sept sauvegardes les plus récentes sur le serveur. Les sauvegardes planifiées nécessitent un appel cron toutes les quelques minutes ou un déclencheur depuis le panneau – le tableau de bord affiche l’adresse et la commande prêtes à l’emploi.
• Une sauvegarde qui survivra à une panne du serveur. Une sauvegarde stockée uniquement sur le même serveur que la boutique disparaît avec lui. Le module envoie chaque sauvegarde terminée vers les emplacements sélectionnés hors serveur et avertit sur le tableau de bord lorsqu’aucun emplacement de ce type n’existe.
• Protection avant une mise à jour. Le bouton « Instantané rapide avant mise à jour » copie la base de données ainsi que les modules, thèmes, surcharges et la configuration – ce qu’une mise à jour peut casser – sans la masse des photos, en une fraction du temps d’une sauvegarde complète.
• Réparation après une panne, un piratage ou une modification ratée. Restauration de toute la boutique ou seulement d’une partie : base de données, fichiers, une table ou un seul répertoire, par exemple un thème.
• Restauration sur un nouveau serveur. Le script d’urgence pdrestore.php restaure la boutique à partir d’une sauvegarde sur un serveur vide, sans PrestaShop installé – après la perte du serveur ou lors d’un changement d’hébergement à la même adresse de boutique.

Ce qui entre dans la sauvegarde

Cinq périmètres de sauvegarde

• Fichiers et base de données – tout ce qu’il faut pour reconstruire la boutique (recommandé).
• Base de données uniquement – sauvegarde petite et rapide, idéale pour des sauvegardes fréquentes entre deux sauvegardes complètes.
• Fichiers uniquement – photos, modules, thèmes et autres fichiers de la boutique.
• Instantané rapide – base de données ainsi que les répertoires modules, themes, override, config, app/config, mails, translations, classes et controllers.
• Périmètre personnalisé – base de données et répertoires de premier niveau sélectionnés ; les fichiers isolés du répertoire racine (index.php, .htaccess et similaires) sont toujours inclus.

Base de données

• Dump en pur PHP. Tables, vues, déclencheurs, procédures, fonctions et événements, sans l’outil mysqldump et sans accès au shell du serveur.
• Tables de la boutique ou base entière. Par défaut, les tables avec le préfixe de la boutique sont copiées ; une option permet d’inclure toutes les tables de la base, par exemple celles d’une intégration externe.
• Tables sans lignes et tables ignorées. Les statistiques de visites, l’index du moteur de recherche, le cache et les journaux entrent dans la sauvegarde sous forme de structure seule. Des listes personnalisées permettent d’ajouter d’autres tables copiées sans lignes ou d’ignorer complètement certaines tables.
• Fermeture de la boutique pendant la copie de la base. Une option du profil bascule la boutique en mode maintenance uniquement pendant les minutes du dump de la base, afin qu’aucune commande ne soit capturée au milieu de son enregistrement, puis la rouvre – même si la sauvegarde échoue.

Fichiers et exclusions

• Toujours ignorés. Cache, journaux, sessions, images temporaires, répertoires .git et node_modules, répertoire des sauvegardes du module lui-même ainsi que les répertoires de sauvegarde d’autres modules de sauvegarde et du module de mise à jour.
• Exclusions personnalisées. Chemins ignorés avec joker (themes/*/cache, **/nom), types de fichiers ignorés (par ex. zip, mp4, psd) et limite de taille d’un fichier individuel.
• Miniatures et photos produits. Des options séparées ignorent les miniatures d’images (elles peuvent être régénérées à partir des originaux) ou tout le répertoire des photos produits, lorsque les photos ont leur propre sauvegarde.
• Fichiers modifiés pendant la sauvegarde. Un fichier modifié, supprimé ou illisible pendant la copie est consigné dans le journal, et la sauvegarde continue.

Compression et découpage en fichiers

• Quatre niveaux de compression gzip – aucune, légère, recommandée et maximale. Les données qui ne se compressent pas (photos, archives) sont enregistrées sans compression par le module, ce qui fait gagner du temps.
• Sauvegarde découpée en fichiers d’une taille choisie (256 Mo par défaut, de 16 à 4096 Mo), ce qui permet de reprendre l’envoi et évite les limites de taille de fichier de l’hébergement. Les fichiers de boutique de plus de 2 Go sont pris en charge.

Planification et sauvegardes automatiques

• Profils de sauvegarde. Chaque profil a son propre périmètre, sa planification, ses destinations, ses règles de suppression des anciennes sauvegardes et son chiffrement – par exemple une sauvegarde complète chaque jour et, en plus, la base seule toutes les quelques heures.
• Planification. Manuel uniquement, toutes les quelques heures (de 1 à 24 heures ou tous les 2 à 7 jours), chaque jour, certains jours de la semaine ou une fois par mois (dans un mois plus court – le dernier jour), à une heure dans le fuseau horaire de la boutique.
• Trois modes de lancement. Adresse cron avec jeton secret (appelée toutes les 5 minutes, nouvelle adresse en un clic), ligne de commande php modules/pdbackupandrestorepro/cli.php avec les commandes cron, run et status – sans limite de temps – ainsi qu’un déclencheur depuis le panneau pour les hébergements sans cron, qui lance une sauvegarde en retard lors de la visite d’un employé dans le panneau.
• Étapes courtes et reprenables. Vous réglez la durée d’une étape de 5 à 120 secondes (20 recommandé). Après chaque étape, la progression est enregistrée, et l’adresse cron appelle elle-même l’étape suivante ; si le serveur ne le permet pas, la sauvegarde est poursuivie lors de l’appel cron suivant.
• Progression en direct. Barre de progression, étape en cours et derniers événements. Fermer l’onglet du navigateur n’interrompt pas la sauvegarde, et le bouton « Arrêter » la termine au prochain point sûr.
• Une seule tâche à la fois. Un verrou en base et un verrou de fichier empêchent que deux processus (par ex. cron et un onglet du navigateur) exécutent la même sauvegarde en même temps. Une tâche qui n’avance pas trois fois de suite se termine par une erreur avec la cause indiquée.

Où stocker les sauvegardes : disque, NAS, FTP, FTPS, SFTP, S3

• Un autre répertoire sur ce serveur – un second disque ou un disque réseau monté (NAS), en dehors du répertoire de la boutique.
• FTP et FTPS. FTPS chiffre la connexion et vérifie le certificat du serveur (la vérification peut être désactivée pour votre propre serveur avec un certificat auto-signé) ; mode passif ou actif.
• SFTP (SSH). Connexion par mot de passe ou clé privée (RSA au format PEM ou clé OpenSSH, y compris protégée par mot de passe ; clés ed25519 là où le cURL de l’hébergement les prend en charge) ainsi qu’empreinte facultative de la clé du serveur, avec laquelle le module ne communique qu’avec le bon serveur.
• Stockage compatible S3. Amazon S3, Backblaze B2, Wasabi, Cloudflare R2, Hetzner, OVH, MinIO et autres services compatibles S3 : adresse du service, région, bucket, répertoire dans le bucket (plusieurs boutiques dans un même bucket) et adressage du bucket dans le chemin. Les gros fichiers sont envoyés en plusieurs parties, et le module ne modifie jamais les paramètres du bucket lui-même.
• Test de connexion. Le bouton « Tester la connexion » enregistre, lit et supprime un fichier d’essai et, lorsque le service le fournit, affiche l’espace libre. Le résultat du dernier test est visible dans la liste des destinations.
• Envoi reprenable. La sauvegarde est envoyée vers les destinations sélectionnées l’une après l’autre et par parties ; un envoi interrompu reprend à l’endroit où il s’est arrêté, et sur les serveurs FTP, FTPS et SFTP la taille du fichier envoyé est comparée à l’original. Les restes d’une sauvegarde qui n’a pas pu être envoyée sont supprimés de la destination.
• Script de restauration avec la sauvegarde. Par défaut, pdrestore.php est également envoyé vers chaque emplacement hors serveur, de sorte que la sauvegarde peut être restaurée même si la boutique et son panneau n’existent plus.

Suppression des anciennes sauvegardes (rétention)

• Dans les destinations. Nombre de sauvegardes les plus récentes conservées dans chaque emplacement, suppression des sauvegardes plus anciennes qu’un nombre de jours choisi, ainsi qu’un historique long selon le schéma jour–semaine–mois : en plus, la sauvegarde la plus récente de chacun des derniers jours, semaines ou mois.
• Sur ce serveur. Nombre distinct de sauvegardes les plus récentes et limite d’âge distincte. En cas de manque d’espace disque, le profil peut supprimer la sauvegarde du serveur lorsqu’elle a atteint au moins une destination.
• Ce que les règles ne suppriment pas. La dernière bonne sauvegarde, les sauvegardes marquées comme protégées (dans la liste des sauvegardes ou pour tout le profil, par ex. les instantanés avant mise à jour) et les sauvegardes à partir desquelles une restauration a été préparée. Les anciennes sauvegardes ne sont supprimées qu’après l’arrivée de la nouvelle sauvegarde à destination.
• Nettoyage des restes. Lorsqu’un profil ne conserve pas les sauvegardes sur le serveur, les sauvegardes téléchargées pour restauration disparaissent du serveur après une semaine, et parmi les sauvegardes qui n’ont pas pu être envoyées, les deux plus récentes y restent. Une suppression interrompue à mi-chemin est relancée. Pour les sauvegardes effectuées en ligne de commande sans profil, les sept plus récentes restent sur le serveur.

Chiffrement des sauvegardes et sécurité

• AES-256 avec contrôle d’intégrité. Chaque fragment de sauvegarde est chiffré avec l’algorithme AES-256 (mode CTR) et signé HMAC-SHA256 ; la clé est dérivée du mot de passe via PBKDF2-SHA256 (200 000 itérations). La liste des fichiers de sauvegarde est également chiffrée, de sorte que les noms de fichiers ne sont pas visibles.
• Détection de substitution. La description de la sauvegarde (manifest) est signée, et chaque fragment est lié à la sauvegarde, au fichier et à sa position dans le fichier – un fragment remplacé, déplacé ou injecté depuis une autre sauvegarde ne passera pas le contrôle.
• Mot de passe de sauvegarde. Au moins 12 caractères, saisi deux fois, stocké sous forme chiffrée et jamais réaffiché ailleurs. Sans le mot de passe, personne ne pourra restaurer une sauvegarde chiffrée, pas même l’auteur du module. Le nouveau mot de passe s’applique aux sauvegardes futures.
• Données de connexion chiffrées. Les mots de passe et clés des destinations sont stockés dans la base sous forme chiffrée et ne reviennent pas dans le formulaire.
• Répertoire de sauvegarde fermé à Internet. Lors de l’installation, le module choisit un répertoire hors de la partie publique du site, si l’hébergement le permet ; sinon, un dossier au nom aléatoire avec des fichiers de protection. Le bouton « Vérifier depuis Internet » sur le tableau de bord vérifie si les fichiers du répertoire peuvent être téléchargés et, pour nginx, fournit une règle de blocage prête à l’emploi.
• Avertissements dans le panneau. La liste des profils avertit lorsque des sauvegardes non chiffrées sont envoyées hors serveur, et la liste des destinations – lorsqu’un emplacement SFTP ne vérifie pas la clé du serveur.
• Aucune connexion aux serveurs de l’auteur. Le module n’envoie pas de données à l’auteur et n’exécute pas de commandes système ; en dehors de votre propre boutique, il se connecte uniquement aux destinations et à l’adresse de monitoring que vous configurez vous-même.

Vérification des sauvegardes et restauration de test

• Vérification de chaque sauvegarde. Après sa création, la sauvegarde est relue, et les sommes SHA-256 de tous ses fragments sont comparées à celles enregistrées. Dans la liste, la sauvegarde reçoit alors le statut « vérifiée ».
• Restauration de test. Lecture complète de la sauvegarde – déchiffrement, décompression, vérification de l’archive et comptage des instructions SQL par rapport à la description de la sauvegarde – sans aucune modification dans la boutique. Une sauvegarde stockée uniquement hors serveur est téléchargée pour cela.
• Rappel. Le tableau de bord signale lorsqu’aucune sauvegarde n’a été lue en entier au cours du dernier mois.

Restauration de la boutique depuis une sauvegarde dans le panneau

• Assistant en trois étapes. Choix de la sauvegarde, choix de ce qui doit être restauré, puis confirmation en saisissant l’adresse de la boutique. Rien ne change avant la confirmation.
• Cinq périmètres de restauration. Tout ce qui se trouve dans la sauvegarde ; base de données uniquement ; fichiers uniquement ; tables sélectionnées ; répertoires sélectionnés (par ex. themes/classic ou img/p).
• D’abord l’état actuel. L’option recommandée effectue avant la restauration une sauvegarde protégée de ce qui sera remplacé – pour les sauvegardes chiffrées, chiffrée avec le mot de passe du profil. Si la restauration s’avère être une erreur, vous revenez à l’état antérieur.
• Contrôle avant le démarrage. Espace disque libre, droit d’écriture dans le répertoire de la boutique, compatibilité du préfixe des tables, version de PrestaShop dont provient la sauvegarde et mot de passe de la sauvegarde chiffrée. Les avertissements sont affichés avant la confirmation.
• Exécution sécurisée. Pendant la restauration, la boutique est fermée aux clients et rouverte à la fin. La restauration fonctionne sur une page séparée hors du panneau, car le panneau lui-même est remplacé pendant ce temps ; après une interruption, elle reprend à l’endroit où elle s’est arrêtée, et la page se supprime après la fin.
• Fichier de configuration et connexion. Le fichier de configuration de PrestaShop provient de la sauvegarde, mais conserve la connexion à la base du serveur actuel. Après la restauration de la base, les employés se connectent avec les comptes du jour où la sauvegarde a été effectuée.
• Sauvegardes hors serveur. Une sauvegarde stockée uniquement dans une destination est téléchargée par le bouton « Télécharger et vérifier » et immédiatement lue en entier avant de servir à la restauration.
• Sauvegardes provenant d’un serveur de base plus récent. Lors de la restauration d’une sauvegarde effectuée sur une version plus récente de MySQL ou MariaDB, les collations inconnues et les modes SQL supprimés sont remplacés par des équivalents, et les autres erreurs sont signalées.
• Restauration interrompue. Une restauration qui ne donne aucun signe de vie pendant 10 minutes peut être abandonnée depuis le panneau – la boutique est rouverte et les sauvegardes reprennent.

Restauration d’urgence sans panneau : pdrestore.php

• Un seul fichier. pdrestore.php peut être téléchargé depuis l’onglet Restauration ; par défaut, il se trouve aussi dans chaque destination à côté de la sauvegarde.
• Sans PrestaShop. Vous téléversez le script avec les fichiers de sauvegarde (noms commençant par pdbr-) dans le répertoire de la boutique et vous l’ouvrez dans le navigateur. S’il n’y a pas de boutique sur le serveur, le script demande les données de la base de données.
• Preuve d’accès au serveur. Le script crée à côté de lui un fichier avec un code qu’il faut recopier – aucune personne étrangère connaissant l’adresse du script ne pourra l’utiliser.
• Reprise et nettoyage. Après une coupure de connexion, la restauration repart de la dernière étape terminée, et à la fin le script se supprime du serveur en un clic. Interface en polonais et en anglais.

Tableau de bord : la boutique est-elle protégée ?

• Évaluation en une phrase. Par exemple « La boutique est protégée. La dernière sauvegarde date de …, la prochaine est planifiée pour … » ou un problème concret : absence de sauvegarde, sauvegarde échouée, sauvegarde trop ancienne, cron inactif, absence d’emplacement hors serveur, répertoire de sauvegarde accessible depuis Internet.
• Liste de contrôle. Dernière sauvegarde, son âge, planification, cron, sauvegarde hors serveur, répertoire de sauvegarde, notifications et restauration de test – chaque point avec un bouton menant à l’endroit où le corriger.
• Tuiles, graphique et événements. Dernière bonne sauvegarde, prochaine sauvegarde, nombre de sauvegardes sur le serveur (avec leur taille) et dans chaque destination, espace disque libre, graphique de la taille et du temps des dernières sauvegardes ainsi que les derniers événements du journal.
• Quatre questions pour commencer. Que sauvegarder, où conserver les sauvegardes, quand et qui notifier – les réponses sont enregistrées dans le profil. Vous pouvez ajouter une nouvelle destination en cours de route et, après un test de connexion réussi, revenir aux questions avec cette destination déjà sélectionnée.
• Test de l’environnement. Version de PHP, extensions, limites de temps et de mémoire, répertoire de sauvegarde et espace disque libre – avec explication de ce que signifie chaque limitation.
• En-tête sur chaque onglet. Dernière bonne sauvegarde, prochaine sauvegarde planifiée et état de la protection visibles depuis chaque page du module.

Notifications e-mail et monitoring

• Alertes. E-mail lorsque la sauvegarde échoue ; lorsqu’une sauvegarde a été créée mais n’a pas atteint toutes les destinations ; lorsqu’un profil n’a nulle part où l’envoyer ; lorsqu’une sauvegarde planifiée n’a pas pu démarrer ; ainsi que lorsqu’il n’y a pas eu de sauvegarde réussie pendant une durée définie (48 heures par défaut).
• Confirmations. E-mail optionnel après chaque sauvegarde réussie, avec la taille et le nombre d’emplacements où elle est stockée.
• Destinataires et langue. Liste libre d’adresses (champ vide = adresse e-mail de la boutique) ; messages dans la langue par défaut de la boutique, en polonais ou en anglais.
• Adresse de monitoring (heartbeat). Appelée après chaque sauvegarde réussie, afin qu’un service de monitoring externe vous avertisse lorsque les sauvegardes cessent d’être créées. Les paramètres indiquent quand cron s’est manifesté pour la dernière fois, et le tableau de bord alerte lorsque cron a cessé d’appeler la boutique.

Liste des sauvegardes et journal

• Liste des sauvegardes. Profil, contenu, taille, durée, emplacements de stockage, résultat de la vérification et protection. Détails de la sauvegarde : taille avant compression, nombre de fichiers et de tables, chiffrement ainsi que versions de PrestaShop et du module qui l’ont créée.
• Actions sur la sauvegarde. Téléchargement des fichiers de sauvegarde sur votre ordinateur (avec possibilité de reprendre le téléchargement), note, protection contre la suppression automatique, restauration de test, restauration et suppression de tous les emplacements à la fois.
• Trouver les sauvegardes dans le répertoire. Les sauvegardes présentes dans le répertoire de sauvegarde mais absentes de la liste (par ex. déplacées depuis un autre serveur) sont ajoutées à la liste en un clic.
• Journal. Chaque étape de la sauvegarde, de l’envoi et de la restauration avec un message clair et traduit ; filtrage et téléchargement du journal sous forme de fichier texte. Les téléchargements de sauvegardes, les restaurations et les abandons de restauration – avec le nom de l’employé – sont conservés pendant deux ans, les autres entrées pendant six mois.

Format de sauvegarde ouvert

• Archives .tar.gz ordinaires. Une sauvegarde non chiffrée peut être ouverte par n’importe quel programme d’archives (7-Zip, WinRAR, tar), et la base se trouve à l’intérieur sous forme de fichiers SQL dans le répertoire db – la sauvegarde ne rend pas dépendant du module.
• Fragments indépendants. Chaque fichier de sauvegarde se compose de fragments compressés et vérifiés séparément, ce qui permet de reprendre la sauvegarde, la vérification, l’envoi et la restauration après une interruption.

Autorisations, multiboutique et désinstallation

• Autorisations des employés. Un employé avec droit de consultation voit les sauvegardes, la progression et le journal ; le lancement des sauvegardes, le téléchargement des fichiers de sauvegarde, la restauration et la modification des paramètres nécessitent le droit de modification. Chaque action dans le panneau vérifie le jeton de sécurité et les autorisations.
• Multiboutique. La sauvegarde couvre toute l’installation PrestaShop – toutes les boutiques à la fois – et les paramètres du module sont communs à l’installation.
• Désinstallation. Supprime les paramètres du module, les planifications et l’historique des sauvegardes. Les fichiers de sauvegarde sur le disque et dans les destinations restent.

Exigences et compatibilité

• PrestaShop 1.7.0–9.x, PHP 7.0–8.5 (64 bits), MySQL 5.6+ ou MariaDB 10+.
• Extensions PHP. zlib (compression, requis), OpenSSL (chiffrement des sauvegardes et protection des données de connexion), cURL (FTP, FTPS, SFTP, S3, vérification du répertoire de sauvegarde depuis Internet et adresse de monitoring) ; SFTP nécessite un cURL compilé avec la prise en charge de SFTP. Le paramètre mbstring.func_overload doit être désactivé.
• Faibles besoins en mémoire. Le moteur de sauvegarde lui-même nécessite environ 20 Mo de mémoire ; une courte limite de temps de requête ne pose pas de problème.
• Sans dépendances. Sans Composer, sans bibliothèques incluses, sans exec ni commandes shell.
• Langues. Interface du module, e-mails et script de restauration en polonais et en anglais.

Limites importantes de fonctionnement (version 1.0)

• La restauration à une autre adresse de boutique ou vers une base avec un autre préfixe de tables n’est pas prise en charge – le module refuse avant la première modification.
• Chaque sauvegarde est une sauvegarde complète de son périmètre ; les sauvegardes incrémentales ne sont pas disponibles.
• Parmi les destinations, il n’y a ni Google Drive ni Dropbox.
• La restauration ne supprime pas les fichiers ni les tables apparus dans la boutique après la création de la sauvegarde.
• Les vues, déclencheurs et procédures ne reviennent que lors de la restauration de toute la base.
• La sauvegarde de la base effectuée via l’adresse cron ou le navigateur se fait en plusieurs étapes courtes ; sur une boutique à fort trafic, l’option de fermeture de la boutique pendant la copie de la base ou le lancement de la sauvegarde en ligne de commande est recommandée.
• Les sauvegardes planifiées nécessitent cron ; le déclencheur depuis le panneau est une solution de secours dépendante des visites des employés.
• Le script d’urgence nécessite le fichier de description de la sauvegarde (le nom se termine par .manifest.json).
• La désinstallation laisse dans le répertoire de la boutique les fichiers d’une restauration commencée et inachevée (pdbr-restore-*) – il faut la terminer, l’abandonner depuis le panneau ou supprimer les fichiers manuellement.
• Le journal conserve pendant deux ans les noms des employés qui ont téléchargé une sauvegarde ou restauré la boutique – il convient d’en tenir compte dans le registre des activités de traitement des données personnelles.