Cloverfield Database Clean-Up

CloverDB Cleanup

Module de nettoyage de base de données pour PrestaShop 7.x à 9.x, compatible multistore.

Gardez votre site web rapide et propre.

Installation

1. Téléchargez cloverdbcleanup.zip.
2. Dans le back-office, rendez-vous dans Modules > Gestionnaire de modules > Téléverser un module.
3. Téléversez le fichier zip et cliquez sur Installer.
4. Le module apparaît sous Paramètres avancés > CloverDB Cleanup.

Mise à jour depuis la version 1.x : téléversez le nouveau fichier zip par-dessus le module existant. Le script de mise à jour conserve vos paramètres, déplace l'élément de menu vers Paramètres avancés et déplace l'emplacement des sauvegardes vers var/modules/cloverdbcleanup/backups/ lorsque l'ancien emplacement par défaut (/backups/) était encore utilisé. Déplacez ou supprimez vous-même les anciennes sauvegardes dans /backups/ : elles ne sont pas répertoriées dans le module.

Aide

Cliquez sur Aide dans l'en-tête du module ou dans la barre d'outils de la page pour accéder à la documentation intégrée, disponible en anglais, néerlandais, allemand, français, espagnol, italien et polonais. Elle s'ouvre dans la langue de votre back-office et vous pouvez changer de langue sur la page d'aide.

Multistore

Le module suit le contexte de boutique sélectionné en haut du back-office.

1. Toutes les boutiques : les paramètres sont enregistrés comme valeurs par défaut globales, et toutes les tâches nettoient les données de chaque boutique.
2. Boutique ou groupe de boutiques : les paramètres sont enregistrés pour cette sélection, et le nettoyage ne supprime que les lignes de ces boutiques.
3. Les visiteurs (ps_guest) et le journal des e-mails (ps_mail) n'ont pas de colonne de boutique ; ils ne peuvent donc être nettoyés que dans le contexte Toutes les boutiques.
4. Le cache de la recherche à facettes et l'index de recherche sont reconstruits pour toutes les boutiques. Il s'agit de caches, que vous pouvez lancer sans risque dans n'importe quel contexte.
5. L'emplacement des sauvegardes est toujours global.

Paramètres

1. Journaux de connexion plus anciens que (par défaut 90 jours) : ps_connections, _page, _source.
2. Visiteurs sans visite depuis (par défaut 90 jours) : ps_guest, visiteurs anonymes uniquement.
3. Conserver les visiteurs ayant un panier plus récent que (par défaut 60 jours) : les visiteurs ayant un panier plus récent sont conservés.
4. Statistiques de recherche plus anciennes que (par défaut 90 jours) : ps_statssearch.
5. Journaux 404 plus anciens que (par défaut 90 jours) : ps_pagenotfound.
6. Journal des e-mails plus ancien que (par défaut 90 jours) : ps_mail.
7. Emplacement des sauvegardes (par défaut var/modules/cloverdbcleanup/backups/) : chemin absolu sur le serveur.

Chaque valeur doit être comprise entre 1 et 3650 jours.

Utilisation, étape par étape

Étape 1 : créer une sauvegarde

Cliquez sur Créer une sauvegarde. Le module écrit un dump SQL de toutes les tables concernées dans l'emplacement des sauvegardes, compressé au format .sql.gz lorsque zlib est disponible. Le nom du fichier contient la date, l'heure et une partie aléatoire, par exemple cloverdb_backup_2026-09-30_143022_k3J9xQ2m.sql.gz. Le dossier est protégé par un fichier .htaccess et un fichier index.php. Sous Nginx, assurez-vous que le dossier n'est pas accessible publiquement (le dossier var/ par défaut est bloqué dans la configuration Nginx standard de PrestaShop).

Étape 2 : vérifier l'aperçu

Le tableau Lignes qui seront supprimées affiche les nombres en fonction des paramètres actuels et du contexte de boutique. Les nombres en rouge indiquent un grand nombre de lignes. Un tiret signifie que la table n'existe pas (par exemple lorsque le module auquel elle appartient n'est pas installé) ou qu'elle n'est pas disponible dans le contexte de boutique actuel.

Étape 3 : nettoyer

Sélectionnez les tâches, cliquez sur Lancer le nettoyage, puis confirmez. Les lignes sont supprimées par lots de 2000, afin que les grandes tables ne bloquent pas la boutique.

1. Journaux de connexion : supprime les anciennes lignes de ps_connections ainsi que les lignes correspondantes dans ps_connections_page et ps_connections_source.
2. Anciens visiteurs : supprime les visiteurs anonymes (non liés à un compte client) sans visite récente et sans panier récent.
3. Cache de la recherche à facettes : vide ps_layered_filter_block, reconstruit automatiquement à la prochaine visite d'une catégorie.
4. Statistiques de recherche : supprime les anciens termes de recherche de ps_statssearch.
5. Journal 404 : supprime les anciennes entrées de ps_pagenotfound.
6. Promotions expirées : supprime les règles de prix catalogue expirées (y compris leurs conditions et les prix générés) ainsi que les prix spécifiques expirés. Les prix sans date de fin ne sont jamais modifiés.
7. Journal des e-mails : supprime les anciennes entrées de ps_mail.

Étape 4 : reconstruire l'index de recherche

Cliquez sur Réindexer pour une réindexation complète via l'indexeur de recherche natif de PrestaShop. Cela peut prendre plusieurs minutes pour les catalogues volumineux.

Restaurer une sauvegarde

Le panneau Restaurer une sauvegarde répertorie toutes les sauvegardes présentes dans l'emplacement des sauvegardes, avec la date, la taille et la version de PrestaShop. Cliquez sur Restaurer, lisez les avertissements, cochez la case de confirmation et cliquez sur Oui, restaurer.

1. La restauration remplace l'intégralité des tables contenues dans la sauvegarde, pour toutes les boutiques. Tout ce qui a été modifié dans ces tables après la sauvegarde est perdu.
2. Possible uniquement dans le contexte Toutes les boutiques.
3. Seules les sauvegardes créées par ce module peuvent être restaurées. Le fichier est vérifié intégralement avant toute modification.
4. Une sauvegarde réalisée avec une autre version de PrestaShop est signalée. La structure des tables peut différer.
5. Mettez la boutique en mode maintenance pendant la restauration et videz le cache ensuite.
6. Supprimer efface un fichier de sauvegarde du serveur.

Bon à savoir

MySQL/MariaDB ne restitue pas l'espace libre au disque après la suppression de lignes dans des tables InnoDB. Exécutez ensuite OPTIMIZE TABLE sur les grandes tables (par exemple ps_connections) via phpMyAdmin si vous souhaitez réduire la taille des fichiers de la base de données.

Prérequis

1. PrestaShop 8.0 jusqu'à 9.x inclus
2. PHP 7.2.5 ou supérieur (PrestaShop 9 nécessite PHP 8.1 ou supérieur)
3. MySQL 5.7 / MariaDB 10.3 ou supérieur
4. Droits d'écriture sur l'emplacement des sauvegardes