Cleanup Revolution : installation et aide

1. Téléversez et installez le ZIP mprcleanuprevolution via "Modules" > "Module Manager".
2. Cliquez sur "Configure". Vous arrivez sur Nettoyage > Paramètres > Configuration pour les paramètres de fichiers et d’images.
3. Choisissez le contexte de boutique souhaité.
4. Ouvrez Nettoyage > Base de données > Configuration de la base de données pour les politiques de base de données.
5. Vérifiez les autorisations du profil employé et le stockage privé des archives avant toute opération destructive sur la base.
6. Commencez dans Nettoyage > Base de données > Tâches de nettoyage et cliquez sur Simuler le nettoyage pour une tâche.
7. Examinez le plan enregistré, la portée, les lignes protégées et les dépendances. Terminez la vérification de sauvegarde et l’approbation lorsqu’elles sont requises avant l’exécution.

Conservez vos sauvegardes habituelles de la base de données et des fichiers de la boutique. Les archives de lignes du module couvrent les plans de nettoyage de base de données admissibles. Elles ne constituent pas une sauvegarde complète des fichiers de la boutique, de toutes les tables ou des services externes.

Les opérations de base de données utilisent les autorisations natives des profils employés. Le module installe des onglets d’autorisation distincts pour Simuler le nettoyage, Nettoyage des statistiques, Nettoyage des données personnelles, Nettoyage du catalogue, Approuver les exécutions destructives, Exécution immédiate et planification, Exporter les sauvegardes chiffrées, Restaurer les sauvegardes et Optimiser les tables.

Consulter un plan exige les droits de consultation de l’aperçu et de la catégorie de tâche. Les opérations destructives vérifient aussi l’autorisation de suppression correspondante. L’approbation, l’export de sauvegarde, la restauration et la maintenance ont des autorisations supplémentaires. L’accès de l’employé aux boutiques est vérifié. L’exécution CLI vérifie également les autorisations et l’accès aux boutiques de l’employé sélectionné.

Les archives de base de données doivent se trouver hors de toutes les racines documentaires publiques. Par défaut, elles se trouvent dans un répertoire caché à côté de la racine de la boutique, nommé .mprcleanuprevolution- suivi d’un hash généré. Un déploiement peut définir la constante PHP MPRDBCLEAN_STORAGE_ROOT sur un autre répertoire privé absolu et MPRDBCLEAN_PUBLIC_ROOTS sur un tableau de racines publiques.

L’utilisateur PHP doit avoir accès à ce stockage. Les répertoires doivent avoir des permissions privées équivalentes à 0700 ; la clé d’archive doit être privée, avec l’équivalent de 0600. Le stockage d’archives via des liens symboliques ou accessible publiquement est refusé. OpenSSL doit prendre en charge aes-256-gcm.

Conservez la clé de chiffrement des archives avec vos éléments privés de récupération. Exporter la sauvegarde chiffrée n’exporte pas cette clé. Pour la CLI, fournissez un DOCUMENT_ROOT valide ou configurez MPRDBCLEAN_PUBLIC_ROOTS afin que le module puisse déterminer les emplacements publics.

Ouvrez Nettoyage > Base de données > Configuration de la base de données. Les paramètres de base de données sont distincts de la configuration fichiers/images.

Les politiques s’héritent selon la portée. Consultez la table des politiques effectives pour confirmer la source et la valeur de chaque boutique. Un changement de politique ou de portée exige un nouvel aperçu. L’approbation est liée au hash du plan enregistré et à l’employé authentifié.

Choisir une tâche de base de données

Le registre des tâches protège les références actives, les commandes historiques et les données d’autres boutiques selon chaque tâche. L’âge inconnu d’un visiteur commence à la première observation. Il ne suppose pas que chaque ligne visiteur est déjà assez ancienne.

Pour Variantes sélectionnées du marchand, renseignez Identifiants des déclinaisons sélectionnées, séparés par des virgules. Cette tâche exige une sélection explicite, un aperçu, une sauvegarde et une approbation. Noms des modules reconnus, séparés par des virgules est disponible pour le processus de dépendances du plan. Lisez le rapport de dépendances avant de l’utiliser.

Les anciens champs de configuration concernant les messages clients fermés, les vues de page, les visiteurs/clients inscrits sans commande, la double confirmation et le nombre global de lignes par lot ne correspondent pas à l’écran actuel des politiques de base de données. Utilisez la liste de tâches et les politiques ci-dessus.

Ouvrez Nettoyage > Base de données > Tâches de nettoyage. Sélectionnez Tâches. Vous pouvez saisir Conservation ponctuelle en jours pour remplacer la valeur dans l’aperçu. Cliquez sur Simuler le nettoyage.

L’espace de travail enregistre une exécution avec un identifiant d’exécution et un hash de plan. Examinez les nombres, boutiques concernées, date limite de conservation, politiques effectives, dépendances, risques, octets logiques estimés et lignes protégées/ignorées. Les grands aperçus peuvent avancer sur plusieurs requêtes bornées.

Pour les tâches nécessitant sauvegarde et approbation :

1. Cliquez sur Vérifier la sauvegarde et attendez la fin de la vérification.
2. Examinez le plan enregistré et cliquez sur Approuver ce plan.
3. Confirmez l’opération destructive.
4. Cliquez sur Exécuter le plan approuvé.
5. Lisez le rapport final. Un résultat partiel ou en échec doit être examiné avant Reprendre l’exécution.

Les tâches statistiques à faible risque n’ont pas les mêmes exigences de sauvegarde/approbation. Vérifiez le plan plutôt que de supposer que chaque opération est récupérable.

Exécuter maintenant utilise le même processus de plan enregistré et les mêmes autorisations. Ce n’est pas un raccourci de suppression inconditionnelle. Annuler l’exécution arrête le travail à venir ; il n’annule pas les lots déjà validés.

Ouvrez Nettoyage > Base de données > Sauvegardes et restauration. Chargez l’identifiant d’exécution, inspectez les éléments sauvegardés et choisissez Simuler la restauration. Examinez les conflits avant Restaurer la sauvegarde vérifiée. La restauration refuse les lignes actives en conflit plutôt que de les remplacer aveuglément.

Utilisez "Export report JSON" ou "Export report CSV" pour le rapport d’exécution. Choisissez un Identifiant de l’élément sauvegardé pour Exporter la sauvegarde chiffrée. Ces téléchargements exigent les autorisations correspondantes.

Purger les archives expirées effectue un entretien borné des archives. La conservation des archives se mesure en heures et est distincte du réglage de corbeille des images orphelines.

L’optimisation des tables utilise aussi cet espace de base de données. Saisissez Tables à optimiser, séparées par des virgules, puis utilisez Simuler l’optimisation des tables, Vérifier la sauvegarde d’optimisation, Approuver l’optimisation des tables et Optimiser les tables. Continuez uniquement après examen du plan. L’optimisation peut verrouiller ou reconstruire des tables de base de données et doit être prévue pendant une période de maintenance adaptée.

"Table Sizes" indique la taille des données, celle des index, l’espace réutilisable/libre et la fragmentation à partir des métadonnées de la base. Les tailles de lignes estiment les données logiques; leur suppression peut laisser de l’espace réutilisable en base sans réduire immédiatement l’espace disque occupé.

Ouvrez Nettoyage > Paramètres > Configuration, avec le titre Configuration du nettoyage.

Cliquez sur Enregistrer la configuration après les modifications. Sur les pages d’actions fichiers/images, examinez Aperçu uniquement, puis choisissez Appliquer le nettoyage pour effectuer les modifications. La préférence de simulation définit le mode initial ; le nettoyage planifié applique toujours les modifications.

Examiner les images

Utilisez "Images" > Images orphelines pour comparer les fichiers image des produits, catégories, fabricants et fournisseurs aux références de la base. Examinez les fichiers avant suppression, surtout en cas de gestion personnalisée des images.

Avec le mode corbeille activé, les images orphelines sélectionnées sont déplacées vers :

/img/_cleanup_trash/YYYY-MM-DD/

Récupérez-les depuis le système de fichiers avant leur suppression définitive par la purge planifiée après la durée de conservation. Lorsque le mode corbeille est désactivé, les images retirées sont supprimées définitivement. Ne confondez pas la corbeille d’images avec les archives chiffrées de base de données.

"Duplicate Images" regroupe par MD5 les fichiers d’images produit identiques et indique l’espace gaspillé estimé. Il ne fusionne pas les affectations d’images et ne supprime pas automatiquement les doublons. Images manquantes signale les images produit référencées dont les fichiers sont introuvables.

Examiner le cache, les fichiers temporaires et les résidus de modules

Fichiers et cache > Nettoyage du cache répertorie le cache Symfony existant, les fichiers compilés/cache Smarty, le cache des ressources du thème, les journaux et le cache d’index des classes. Examinez les groupes avant de les vider. Vider le cache peut entraîner sa régénération lors des requêtes suivantes.

Fichiers temporaires répertorie les fichiers temporaires d’images et d’import pour examen et suppression manuels, y compris ceux plus récents que le seuil de conservation. Une sélection manuelle peut aussi supprimer ces fichiers récents. Le paramètre de conservation s’applique au nettoyage automatique des fichiers temporaires et à l’action de nettoyage des images temporaires dans les chemins pris en charge.

Résidus du module distingue les dossiers de modules désinstallés, les dossiers mis de côté et les entrées qui ne sont pas des modules. Seuls les dossiers admissibles de modules désinstallés disposent du processus de suppression. Supprimer un dossier efface ses fichiers. Exportez auparavant ce dont vous avez besoin. Les tables MPR et clés de configuration candidates sont des informations à examiner ; cette page ne supprime pas automatiquement ces tables ni toutes les clés MPR%.

Détecteur de doublons signale les produits en double par nom/référence/EAN/UPC, ainsi que les catégories, caractéristiques et attributs. Examinez-les et résolvez-les manuellement. Il ne fusionne pas les entités du catalogue.

L’espace de base de données fournit :

php modules/mprcleanuprevolution/bin/cleanup.php --help
php modules/mprcleanuprevolution/bin/cleanup.php --employee=1 --shops=1 --task=old_carts --preview

Remplacez les identifiants par ceux d’un employé actif autorisé et des boutiques souhaitées. Utilisez --shops=1,2 pour une liste explicite autorisée. --global est un choix de portée explicite distinct. La commande ne contourne pas les autorisations des profils.

Les étapes d’une exécution enregistrée sont des commandes séparées :

php modules/mprcleanuprevolution/bin/cleanup.php --employee=1 --shops=1 --run-id=RUN_ID --verify-backup
php modules/mprcleanuprevolution/bin/cleanup.php --employee=1 --shops=1 --run-id=RUN_ID --approve --plan-hash=PLAN_HASH
php modules/mprcleanuprevolution/bin/cleanup.php --employee=1 --shops=1 --run-id=RUN_ID --execute

Utilisez l’identifiant d’exécution et le hash réels du rapport examiné. Utilisez un seul indicateur d’opération par commande. La restauration utilise --restore-preview, puis --restore --plan-hash=PLAN_HASH. --batches=N enregistre un point de reprise après un nombre borné de lots. Les surcharges d’aperçu comprennent --retention-days, --batch-size, --row-budget, --time-budget-ms, --combination-ids et --acknowledged-modules. Un plan enregistré ne peut pas être modifié en ajoutant ces surcharges.

L’exécuteur cron MPR partagé vérifie database_cleanup chaque minute. Enregistrez une expression cron à cinq champs et un fuseau horaire dans la politique de tâche pour activer sa planification, ou laissez la planification vide pour la désactiver. Les exécutions utilisent les autorisations et l’accès aux boutiques de l’employé ayant enregistré la politique. Le planificateur crée un aperçu enregistré et prépare les sauvegardes requises ; les tâches nécessitant une approbation attendent l’examen et l’approbation du plan dans Tâches de nettoyage avant de continuer.

La tâche distincte file_cleanup, intitulée "Clean Cache & Temp Files", s’exécute à daily:03:30. Elle vide les groupes de cache pris en charge, supprime les fichiers temporaires plus anciens que le seuil configuré et purge définitivement les dossiers expirés de la corbeille d’images. Elle applique les modifications même avec la simulation par défaut activée. Si les rapports sont activés, per-run envoie un rapport après ce callback ; daily envoie un résumé via email_report à daily:05:00.

Après chaque exécution, inspectez Historique de la base de données et son rapport pour les travaux terminés, ignorés, partiels ou échoués. Les opérations fichiers/images écrivent aussi dans l’historique de nettoyage du module avec les nombres concernés, estimations d’espace, durée et détails de l’employé/du déclencheur.

Si une action de base de données est indisponible, vérifiez les autorisations du profil, les boutiques sélectionnées, les valeurs effectives de Activé, la politique de tâche, la révision du plan et la sauvegarde requise. Si la vérification de sauvegarde échoue, contrôlez l’emplacement privé, les permissions, les déclarations de racines publiques et la prise en charge d’OpenSSL. Si une restauration signale des conflits, examinez les lignes actives modifiées avant de créer un nouvel aperçu de restauration.

Utilisez Nettoyage > Paramètres > Vérification système pour les tables partagées et les problèmes de version d’exécution. Si l’exécution s’arrête sur un budget, inspectez l’exécution enregistrée et reprenez-la plutôt que de créer une opération de suppression sans lien.

Pour arrêter les suppressions de base de données, définissez sa valeur effective Activé sur Non. Désactivez Nettoyage des fichiers et des images activé pour bloquer le nettoyage planifié et manuel des fichiers/images, y compris la suppression de dossiers de modules. Désactivez séparément Activer les rapports par e-mail pour arrêter les e-mails de rapport. Désactivez l’ensemble du module dans "Module Manager" si vous devez arrêter tout accès au module. Ces paramètres sont distincts.

La désinstallation supprime le menu et l’enregistrement du module. Les journaux de nettoyage partagés et les archives de récupération sont conservés pour les autres modules qui les utilisent. La désinstallation ne restaure pas les lignes ou fichiers supprimés. Conservez les données et clés de récupération nécessaires jusqu’à satisfaction de vos obligations de conservation et besoins de récupération.

Nécessite PrestaShop 1.6.1 ou une version ultérieure et PHP 7.1 ou une version ultérieure.