Cloverfield Database Clean-Up

CloverDB Cleanup

Moduł do czyszczenia bazy danych dla PrestaShop 7.x do 9.x, gotowy na multistore.

Dbaj o to, by Twój sklep był szybki i czysty.

Instalacja

1. Pobierz plik cloverdbcleanup.zip.
2. W panelu administracyjnym przejdź do Moduły > Menedżer modułów > Załaduj moduł.
3. Prześlij plik zip i kliknij Zainstaluj.
4. Moduł pojawi się w sekcji Parametry zaawansowane > CloverDB Cleanup.

Aktualizacja z wersji 1.x: prześlij nowy plik zip na istniejący moduł. Skrypt aktualizacji zachowa Twoje ustawienia, przeniesie pozycję menu do sekcji Parametry zaawansowane i, jeśli używana była jeszcze dawna domyślna lokalizacja (/backups/), przeniesie lokalizację kopii zapasowych do var/modules/cloverdbcleanup/backups/. Stare kopie zapasowe z katalogu /backups/ przenieś lub usuń samodzielnie, ponieważ nie są one wyświetlane w module.

Pomoc

Kliknij Pomoc w nagłówku modułu lub na pasku narzędzi strony, aby otworzyć wbudowaną dokumentację dostępną w językach: angielskim, niderlandzkim, niemieckim, francuskim, hiszpańskim, włoskim i polskim. Dokumentacja otwiera się w języku Twojego panelu administracyjnego, a język możesz zmienić na stronie pomocy.

Multistore

Moduł działa zgodnie z kontekstem sklepu wybranym u góry panelu administracyjnego.

1. Wszystkie sklepy: ustawienia są zapisywane jako globalne ustawienia domyślne, a wszystkie zadania czyszczą dane każdego sklepu.
2. Sklep lub grupa sklepów: ustawienia są zapisywane dla wybranego zakresu, a czyszczenie usuwa wiersze tylko z tych sklepów.
3. Tabele gości (ps_guest) i logu e-maili (ps_mail) nie mają kolumny sklepu, dlatego można je czyścić tylko w kontekście Wszystkie sklepy.
4. Pamięć podręczna wyszukiwania fasetowego i indeks wyszukiwania są odbudowywane dla wszystkich sklepów. To pamięci podręczne, więc można je bezpiecznie uruchamiać w dowolnym kontekście.
5. Lokalizacja kopii zapasowych jest zawsze globalna.

Ustawienia

1. Logi połączeń starsze niż (domyślnie 90 dni): ps_connections, _page, _source.
2. Goście bez wizyty od (domyślnie 90 dni): ps_guest, wyłącznie anonimowi odwiedzający.
3. Zachowaj gości z koszykiem nowszym niż (domyślnie 60 dni): goście z nowszym koszykiem są zachowywani.
4. Statystyki wyszukiwania starsze niż (domyślnie 90 dni): ps_statssearch.
5. Logi 404 starsze niż (domyślnie 90 dni): ps_pagenotfound.
6. Log e-maili starszy niż (domyślnie 90 dni): ps_mail.
7. Lokalizacja kopii zapasowych (domyślnie var/modules/cloverdbcleanup/backups/): ścieżka bezwzględna na serwerze.

Każda wartość musi mieścić się w przedziale od 1 do 3650 dni.

Obsługa krok po kroku

Krok 1: Utwórz kopię zapasową

Kliknij Utwórz kopię zapasową. Moduł zapisuje zrzut SQL wszystkich objętych tabel w lokalizacji kopii zapasowych, skompresowany do formatu .sql.gz, jeśli dostępna jest biblioteka zlib. Nazwa pliku zawiera datę, godzinę i losowy ciąg znaków, np. cloverdb_backup_2026-09-30_143022_k3J9xQ2m.sql.gz. Folder jest zabezpieczony plikami .htaccess i index.php. Na serwerze Nginx upewnij się, że folder nie jest publicznie dostępny (domyślny folder var/ jest blokowany w standardowej konfiguracji Nginx dla PrestaShop).

Krok 2: Sprawdź podgląd

Tabela Wiersze, które zostaną usunięte pokazuje liczby na podstawie bieżących ustawień i kontekstu sklepu. Czerwone liczby oznaczają dużą liczbę wierszy. Myślnik oznacza, że tabela nie istnieje (np. gdy moduł, do którego należy, nie jest zainstalowany) lub jest niedostępna w bieżącym kontekście sklepu.

Krok 3: Wyczyść dane

Wybierz zadania i kliknij Rozpocznij czyszczenie, a następnie potwierdź. Wiersze są usuwane w partiach po 2000, dzięki czemu duże tabele nie blokują sklepu.

1. Logi połączeń: usuwa stare wiersze z ps_connections wraz z odpowiadającymi im wierszami w ps_connections_page i ps_connections_source.
2. Starzy goście: usuwa anonimowych gości (niepowiązanych z kontem klienta), którzy nie odwiedzili sklepu od dłuższego czasu i nie mają niedawnego koszyka.
3. Pamięć podręczna wyszukiwania fasetowego: opróżnia ps_layered_filter_block, odbudowywaną automatycznie przy kolejnej wizycie w kategorii.
4. Statystyki wyszukiwania: usuwa stare wyszukiwane frazy z ps_statssearch.
5. Log 404: usuwa stare wpisy z ps_pagenotfound.
6. Wygasłe rabaty: usuwa wygasłe reguły cen katalogowych (wraz z ich warunkami i wygenerowanymi cenami) oraz wygasłe ceny specjalne. Ceny bez daty zakończenia nigdy nie są ruszane.
7. Log e-maili: usuwa stare wpisy z ps_mail.

Krok 4: Odbuduj indeks wyszukiwania

Kliknij Przeindeksuj, aby wykonać pełne przeindeksowanie za pomocą wbudowanego indeksera wyszukiwania PrestaShop. W przypadku dużych katalogów może to potrwać kilka minut.

Przywracanie kopii zapasowej

Panel Przywróć kopię zapasową wyświetla wszystkie kopie zapasowe z lokalizacji kopii zapasowych wraz z datą, rozmiarem i wersją PrestaShop. Kliknij Przywróć, przeczytaj ostrzeżenia, zaznacz pole potwierdzenia i kliknij Tak, przywróć.

1. Przywracanie zastępuje całe tabele zawarte w kopii zapasowej, dla wszystkich sklepów. Wszystko, co zmieniło się w tych tabelach po utworzeniu kopii, zostanie utracone.
2. Możliwe tylko w kontekście Wszystkie sklepy.
3. Można przywracać wyłącznie kopie zapasowe utworzone przez ten moduł. Plik jest w całości sprawdzany, zanim cokolwiek zostanie zmienione.
4. Kopia zapasowa utworzona w innej wersji PrestaShop jest oznaczona. Struktura tabel może się różnić.
5. Na czas przywracania włącz w sklepie tryb konserwacji, a po jego zakończeniu wyczyść pamięć podręczną.
6. Usuń kasuje plik kopii zapasowej z serwera.

Warto wiedzieć

MySQL/MariaDB nie zwraca wolnego miejsca na dysku po usunięciu wierszy z tabel InnoDB. Jeśli chcesz zmniejszyć pliki bazy danych, uruchom potem OPTIMIZE TABLE na dużych tabelach (np. ps_connections) za pomocą phpMyAdmin.

Wymagania

1. PrestaShop od 8.0 do 9.x włącznie
2. PHP 7.2.5 lub nowszy (PrestaShop 9 wymaga PHP 8.1 lub nowszego)
3. MySQL 5.7 / MariaDB 10.3 lub nowszy
4. Uprawnienia do zapisu w lokalizacji kopii zapasowych