Cloverfield Database Clean-Up

CloverDB Cleanup

Datenbank-Cleanup-Modul für PrestaShop 7.x bis 9.x, multistore-fähig.

Halten Sie Ihre Website schnell und sauber.

Installation

1. Laden Sie cloverdbcleanup.zip herunter.
2. Gehen Sie im Back Office zu Module > Module Manager > Modul hochladen.
3. Laden Sie die ZIP-Datei hoch und klicken Sie auf Installieren.
4. Das Modul erscheint unter Erweiterte Einstellungen > CloverDB Cleanup.

Update von 1.x: Laden Sie die neue ZIP-Datei über das vorhandene Modul hoch. Das Update-Skript behält Ihre Einstellungen bei, verschiebt den Menüpunkt zu „Erweiterte Einstellungen“ und verlegt den Backup-Speicherort nach var/modules/cloverdbcleanup/backups/, sofern noch der alte Standard (/backups/) verwendet wurde. Verschieben oder löschen Sie alte Backups in /backups/ bitte selbst – sie werden im Modul nicht aufgelistet.

Hilfe

Klicken Sie im Modul-Header oder in der Symbolleiste der Seite auf Hilfe, um die integrierte Dokumentation aufzurufen. Sie ist auf Englisch, Niederländisch, Deutsch, Französisch, Spanisch, Italienisch und Polnisch verfügbar. Sie öffnet sich in der Sprache Ihres Back Office, und auf der Hilfeseite können Sie die Sprache wechseln.

Multistore

Das Modul folgt dem Shop-Kontext, der oben im Back Office ausgewählt ist.

1. Alle Shops: Die Einstellungen werden als globaler Standard gespeichert, alle Aufgaben bereinigen die Daten sämtlicher Shops.
2. Shop oder Shop-Gruppe: Die Einstellungen werden für diese Auswahl gespeichert, die Bereinigung entfernt nur Datensätze dieser Shops.
3. Gäste (ps_guest) und das E-Mail-Protokoll (ps_mail) haben keine Shop-Spalte und können daher nur im Kontext „Alle Shops“ bereinigt werden.
4. Der Cache der Facettensuche und der Suchindex werden für alle Shops neu aufgebaut. Es handelt sich um Caches, die Sie in jedem Kontext bedenkenlos ausführen können.
5. Der Backup-Speicherort ist immer global.

Einstellungen

1. Verbindungsprotokolle älter als (Standard 90 Tage): ps_connections, _page, _source.
2. Gäste ohne Besuch seit (Standard 90 Tage): ps_guest, nur anonyme Besucher.
3. Gäste mit einem Warenkorb behalten, der neuer ist als (Standard 60 Tage): Gäste mit einem aktuelleren Warenkorb bleiben erhalten.
4. Suchstatistiken älter als (Standard 90 Tage): ps_statssearch.
5. 404-Protokolle älter als (Standard 90 Tage): ps_pagenotfound.
6. E-Mail-Protokoll älter als (Standard 90 Tage): ps_mail.
7. Backup-Speicherort (Standard var/modules/cloverdbcleanup/backups/): absoluter Pfad auf dem Server.

Jeder Wert muss zwischen 1 und 3650 Tagen liegen.

Anwendung Schritt für Schritt

Schritt 1: Backup erstellen

Klicken Sie auf Backup erstellen. Das Modul schreibt einen SQL-Dump aller betroffenen Tabellen in den Backup-Speicherort, komprimiert als .sql.gz, sofern zlib verfügbar ist. Der Dateiname enthält Datum, Uhrzeit und einen zufälligen Teil, z. B. cloverdb_backup_2026-09-30_143022_k3J9xQ2m.sql.gz. Der Ordner ist durch eine .htaccess und eine index.php geschützt. Stellen Sie bei Nginx sicher, dass der Ordner nicht öffentlich zugänglich ist (der Standardordner var/ ist in der Standard-Nginx-Konfiguration von PrestaShop gesperrt).

Schritt 2: Vorschau prüfen

Die Tabelle Zeilen, die entfernt werden zeigt die Anzahl auf Basis der aktuellen Einstellungen und des aktuellen Shop-Kontexts. Rote Zahlen weisen auf eine große Anzahl an Zeilen hin. Ein Strich bedeutet, dass die Tabelle nicht existiert (zum Beispiel, wenn das zugehörige Modul nicht installiert ist) oder im aktuellen Shop-Kontext nicht verfügbar ist.

Schritt 3: Bereinigen

Wählen Sie die Aufgaben aus, klicken Sie auf Bereinigung starten und bestätigen Sie. Die Zeilen werden in Batches zu je 2000 entfernt, sodass große Tabellen den Shop nicht blockieren.

1. Verbindungsprotokolle: entfernt alte Zeilen aus ps_connections samt den zugehörigen Zeilen in ps_connections_page und ps_connections_source.
2. Alte Gäste: entfernt anonyme Gäste (ohne Verknüpfung mit einem Kundenkonto) ohne aktuellen Besuch und ohne aktuellen Warenkorb.
3. Cache der Facettensuche: leert ps_layered_filter_block; der Cache wird beim nächsten Kategoriebesuch automatisch neu aufgebaut.
4. Suchstatistiken: entfernt alte Suchbegriffe aus ps_statssearch.
5. 404-Protokoll: entfernt alte Einträge aus ps_pagenotfound.
6. Abgelaufene Rabatte: entfernt abgelaufene Katalogpreisregeln (einschließlich ihrer Bedingungen und generierten Preise) sowie abgelaufene Spezialpreise. Preise ohne Enddatum werden nie angetastet.
7. E-Mail-Protokoll: entfernt alte Einträge aus ps_mail.

Schritt 4: Suchindex neu aufbauen

Klicken Sie auf Neu indexieren, um über den PrestaShop-eigenen Suchindexer eine vollständige Neuindexierung durchzuführen. Bei großen Katalogen kann dies mehrere Minuten dauern.

Backup wiederherstellen

Das Panel Backup wiederherstellen listet alle Backups im Backup-Speicherort mit Datum, Größe und PrestaShop-Version auf. Klicken Sie auf Wiederherstellen, lesen Sie die Warnhinweise, setzen Sie das Häkchen im Bestätigungsfeld und klicken Sie auf Ja, wiederherstellen.

1. Beim Wiederherstellen werden die vollständigen Tabellen aus dem Backup ersetzt, und zwar für alle Shops. Alles, was sich nach dem Backup in diesen Tabellen geändert hat, geht verloren.
2. Nur im Kontext Alle Shops möglich.
3. Es können nur Backups wiederhergestellt werden, die mit diesem Modul erstellt wurden. Die Datei wird vollständig geprüft, bevor etwas geändert wird.
4. Ein Backup, das mit einer anderen PrestaShop-Version erstellt wurde, wird gekennzeichnet. Die Tabellenstruktur kann abweichen.
5. Versetzen Sie den Shop während der Wiederherstellung in den Wartungsmodus und leeren Sie anschließend den Cache.
6. Löschen entfernt eine Backup-Datei vom Server.

Gut zu wissen

MySQL/MariaDB gibt nach dem Löschen von Zeilen aus InnoDB-Tabellen den freien Speicherplatz nicht an die Festplatte zurück. Führen Sie anschließend über phpMyAdmin OPTIMIZE TABLE für die großen Tabellen aus (zum Beispiel ps_connections), wenn die Datenbankdateien kleiner werden sollen.

Voraussetzungen

1. PrestaShop 8.0 bis einschließlich 9.x
2. PHP 7.2.5 oder höher (PrestaShop 9 erfordert PHP 8.1 oder höher)
3. MySQL 5.7 / MariaDB 10.3 oder höher
4. Schreibrechte für den Backup-Speicherort