Aktualizacja modułu Prestashop – poradnik krok po kroku

Ten kompletny poradnik aktualizacji PrestaShop prowadzi przez cały proces: od sprawdzenia wersji i audytu modułów, przez kopię zapasową i testy na środowisku roboczym, aż po analizę błędów po wdrożeniu.

Jak przygotować sklep do aktualizacji PrestaShop

Najpierw należy sprawdzić aktualną wersję w panelu administracyjnym, w sekcji Parametry zaawansowane → Informacje, bo od tego zależy dalsza aktualizacja wersji i dobór właściwej metody. Więcej o tym, jak wygląda aktualizacja modułu PrestaShop, opisano na stronie usługi.

Weryfikacja wersji i wymagań systemowych

Trzeba porównać obecną wersję sklepu z wymaganiami wersji docelowej, bo upgrade PrestaShop w obrębie tej samej linii działa inaczej niż przejście między głównymi wydaniami.

Równie ważne jest środowisko, czyli serwer i konfiguracja na hostingu. Niezgodne PHP, zbyt niski limit pamięci albo brak wymaganych rozszerzeń potrafią zatrzymać proces jeszcze przed uruchomieniem właściwego skryptu.

• PrestaShop 1.7 – wymagania PHP: wersje w zakresie 7.1–8.0, MySQL co najmniej 5.6, memory_limit 256 MB oraz max_execution_time 300 sekund.
• PrestaShop 9 – wymagania PHP PHP 8.1–8.3, MySQL 5.7 i memory_limit 512 MB; brak tych parametrów zablokuje upgrade PrestaShop już na starcie.
• Rozszerzenia PHP Aktywne curl, gd, zip, intl i pdo_mysql są obowiązkowe, bo bez nich mogą pojawić się problemy z koszykiem, płatnościami lub samym rozpakowaniem paczki instalacyjnej na hostingu.

Uprawnienia katalogów powinny wynosić 755 dla folderów i 644 dla plików. Warto sprawdzić przed wdrożeniem, czy serwer obsługuje wymagania danej wersji PrestaShop, bo dopiero wtedy aktualizacja sklepu ma sens techniczny.

Na tym etapie dobrze rozdzielić dwa scenariusze: zwykłą aktualizację PrestaShop i migrację między głównymi wersjami. Usługa aktualizacji PrestaShop 1.7 dotyczy zmian w tej samej linii, natomiast przejście do PrestaShop 9 wymaga osobnego planu migracyjnego.

Audyt modułów i kopie zapasowe przed upgrade

Gdy wersja i środowisko są już sprawdzone, kolejnym krokiem jest audyt rozszerzeń. To właśnie tutaj najczęściej zaczynają się problemy, dlatego przed rozpoczęciem aktualizacji warto przygotować pełną listę modułów, także tych wyłączonych, i wskazać elementy krytyczne dla sprzedaży, płatności oraz dostaw.

• Lista modułów Należy sprawdzić wszystkie rozszerzenia w panelu administracyjnym, również nieaktywne, bo każde z nich może wpływać na aktualizację sklepu.
• Backup bazy danych Kopię należy wykonać przez phpMyAdmin lub inne narzędzie dostępne na hostingu; kopia zapasowa PrestaShop powinna być możliwa do odtworzenia, inaczej nie spełnia swojej funkcji.
• Pliki sklepu Pobranie kompletu plików przez FTP lub SFTP i zachowanie ich osobno jako kopii zapasowej PrestaShop. To krok, który często się pomija.

Przed rozpoczęciem aktualizacji należy też ustalić, czy w rdzeniu systemu były wprowadzane ręczne zmiany. Jeśli tak, podczas aktualizacji mogą zostać nadpisane, dlatego trzeba je wcześniej opisać i zabezpieczyć.

Jeżeli celem jest bezpieczne zaktualizowanie PrestaShop, potrzebna jest nie tylko kopia zapasowa, ale też weryfikacja procesu odtworzenia. Sama kopia zapasowa i backup bazy danych bez testu przywracania nie dają realnej ochrony.

Dlaczego moduł PrestaShop nie działa przed aktualizacją

Zanim pojawi się pytanie, dlaczego moduł PrestaShop nie działa podczas aktualizacji, warto sprawdzić, czy problem nie występuje już wcześniej. Często przyczyną jest niezgodność modułu z obecną wersją PHP, brak rozszerzenia systemowego albo inna konfiguracja serwera produkcyjnego niż środowiska testowego.

Różnica ujawnia się przy porównaniu działania lokalnie i na hostingu. Moduł może działać poprawnie w jednym miejscu, a blokować się w drugim, bo na hostingu brakuje zip, intl lub odpowiednich limitów pamięci.

Szczegółową diagnostykę i typowe problemy opisuje poradnik aktualizacji modułu. Gdy już pojawia się błąd, należy sprawdzić logi błędów zamiast opierać się wyłącznie na komunikacie z ekranu: właśnie tam zwykle widać, który plik lub moduł zatrzymuje aktualizację PrestaShop.

Przed rozpoczęciem dalszych działań warto pobrać logi i zachować ich kopię. Taki materiał ułatwia późniejszą analizę problemów podczas aktualizacji i pozwala szybciej ustalić, jak przygotować sklep do upgrade bez powtarzania tych samych błędów.

Aktualizacja PrestaShop metodą 1-Click Upgrade i ręcznie

Istnieją dwie podstawowe metody aktualizacji PrestaShop: moduł 1-Click Upgrade oraz podejście ręczne przez FTP. Wybór zależy od skali wdrożenia, liczby integracji i tego, kto ma wykonać aktualizację. W obu wariantach kopia zapasowa i środowisko testowe nie są dodatkiem, tylko punktem wyjścia.

Jak działa moduł 1-Click Upgrade krok po kroku

Aktualizacja PrestaShop z użyciem modułu 1-Click Upgrade pozwala zautomatyzować większość procesu i ograniczyć ręczne przenoszenie plików. W zależności od wersji systemu najpierw trzeba włączyć tryb konserwacji, aby podczas aktualizacji klienci nie widzieli niespójnych danych. Sam moduł 1-Click Upgrade sprawdza środowisko, a następnie przygotowuje kopię danych przed zmianą wersji.

• Punkty kontrolne Moduł weryfikuje wymagania systemowe, zgodność modułów i stan instalacji przed startem procesu: pozwala to uniknąć błędów jeszcze przed właściwą zmianą.
• Backup Narzędzie tworzy kopię zapasową plików i bazy danych, jednak warto mieć też własny, niezależny backup zapisany poza sklepem.
• Tryb konserwacji Jeśli moduł 1-Click Upgrade zostanie uruchomiony bez wcześniejszego wyłączenia ruchu klientów, działanie sklepu internetowego może być chwilowo niespójne.

To rozwiązanie bywa wygodniejsze, gdy trzeba bezpiecznie zaktualizować standardowy sklep bez rozbudowanych zmian w kodzie. Z kolei gdy serwer nie spełnia wymagań, 1-Click Upgrade zatrzyma operację na etapie weryfikacji i wskaże problem. Dzięki temu łatwiej ocenić, czy nowa wersja może zostać wdrożona bez ryzyka.

Ręczna aktualizacja PrestaShop przez FTP

Ręczna ścieżka daje pełną kontrolę nad plikami i kolejnością działań. Dlatego naprawa i utrzymanie sklepu PrestaShop często opiera się właśnie na tej metodzie przy wdrożeniach z modyfikowanym rdzeniem, niestandardowym motywem lub dodatkowymi integracjami. Różnica ujawnia się przy sklepach, w których automatyzacja nie powinna nadpisywać zmian bez nadzoru.

• Pobierz paczkę Pobierz aktualne pliki PrestaShop z oficjalnego źródła i sprawdź integralność archiwum przed rozpakowaniem.
• Wgranie na serwer Pliki należy przesłać na serwer przez FTP lub SFTP, nadpisując rdzeń i zachowując osobno elementy niestandardowe.
• Uruchomienie upgrade Po wgraniu plików trzeba uruchomić skrypt pod adresem domena.com/install/upgrade.php: dopiero wtedy baza danych zostaje dostosowana do nowej wersji.
• Uprawnienia Często pomijanym etapem jest kontrola uprawnień katalogów i plików, ponieważ błędne wartości mogą zablokować zapis podczas procesu.

Warto regularnie podnosić wersję systemu, ponieważ każda kolejna aktualizacja PrestaShop obejmuje nie tylko poprawki bezpieczeństwa, ale też zgodność z nowszymi integracjami i zmianami w API. Gdy przerwa między wydaniami robi się zbyt długa, trudniej później zaktualizować sklep bez dodatkowych prac naprawczych.

Staging, testy i naprawa sklepu PrestaShop po aktualizacji

Niezależnie od wybranej ścieżki, najpierw należy bezpiecznie zaktualizować kopię sklepu na środowisku stagingowym. Serwer testowy powinien możliwie dokładnie odwzorowywać produkcję, o ile wyniki mają później służyć do realnej oceny ryzyka. Dopiero wtedy można zdecydować, którą z metod aktualizacji PrestaShop wybrać dla wersji produkcyjnej.

Testy powinny objąć cały przebieg zamówienia oraz integracje z systemami zewnętrznymi. Przed wdrożeniem należy zweryfikować również SEO, przekierowania i adresy URL, ponieważ nowa wersja może zmienić zachowanie sklepu w tych obszarach. Gdy już wszystko działa poprawnie, można wykonać aktualizację na produkcji i ponownie zweryfikować działanie sklepu internetowego.

Rozwiązywanie problemów po aktualizacji PrestaShop

Nawet dobrze przygotowana aktualizacja sklepu potrafi ujawnić problemy dopiero po wdrożeniu na produkcję. W praktyce oznacza to, że rozwiązywanie problemów PrestaShop trzeba zacząć od diagnostyki, bo dopiero wtedy wiadomo, czy zawiódł moduł, plik rdzenia, cache czy sam serwer.

Biały ekran i błąd 500 – jak włączyć tryb debugowania

Biały ekran nie pojawia się przypadkowo. PrestaShop ukrywa szczegóły błędów przed użytkownikami, a problem z modułem PrestaShop albo uszkodzony plik rdzenia staje się widoczny dopiero po uruchomieniu debugowania.

Można to zrobić na kilka sposobów: przez edycję pliku /config/defines.inc.php, zmianę wartości PS_DEBUG_MODE w bazie przez phpMyAdmin albo odpowiednią opcję w panelu, o ile zaplecze nadal działa. To zależy od wersji sklepu.

• Edycja pliku defines.inc.php: w katalogu /config/ na serwerze należy zmienić wartość stałej _PS_MODE_DEV_ na true.
• Logi błędów: katalog /var/logs/ zwykle pokazuje dokładny plik, numer linii i nazwę modułu, które powodują błąd 500.
• Cache i dostęp do zaplecza: gdy problemy dotyczą logowania lub pracy w panelu administracyjnym, przyczyną bywa zablokowany cache; wtedy pomaga zmiana nazwy katalogu cache albo jego wyczyszczenie przez SSH.

Po usunięciu błędu debugowanie trzeba wyłączyć. To kwestia bezpieczeństwa i ochrony danych, ponieważ aktywny tryb deweloperski ujawnia ścieżki plików, strukturę aplikacji i inne informacje, które nie powinny być dostępne publicznie.

Problem z modułem PrestaShop: diagnostyka i naprawa

Najczęściej problem z modułem PrestaShop wychodzi na jaw dopiero po tym, jak nowa wersja sklepu zaczyna ładować starsze rozszerzenie. Różnica ujawnia się przy zgodności klas, hooków albo sposobu renderowania w zapleczu i na froncie.

Jeśli dostęp do zaplecza jest zachowany, warto wyłączać rozszerzenia po kolei w panelu administracyjnym i po każdej zmianie sprawdzać działanie sklepu. Gdy już panel nie odpowiada, szybszą metodą jest zmiana nazwy folderu modułu w katalogu /modules/ przez FTP, na przykład przez dodanie sufiksu _OFF.

O ile dostęp do zaplecza jest całkowicie zablokowany, można odłączyć moduł także na poziomie bazy. W panelu phpMyAdmin usunięcie odpowiedniego wiersza z tabeli ps_module odłącza rozszerzenie od systemu bez kasowania jego plików, co pozwala kontynuować rozwiązywanie problemów PrestaShop.

• Metoda eliminacji w panelu: wyłączanie modułów kolejno w sekcji Moduły → Menedżer modułów i test po każdej zmianie.
• Zmiana nazwy przez FTP: dodanie sufiksu _OFF do folderu w /modules/, gdy sklep działa, ale brak dostępu w panelu utrudnia diagnostykę.
• Odłączenie przez phpMyAdmin: usunięcie wpisu z tabeli ps_module, gdy nie da się wejść do zaplecza.
• Brak zdjęć produktów: po aktualizacji sklepu PrestaShop często trzeba ponownie wygenerować miniatury w sekcji Projekt → Obrazy → Generowanie miniatur; to nie musi oznaczać awarii modułu.

Jeśli winne okazuje się płatne rozszerzenie, nowa wersja modułu może wymagać kontaktu z autorem i zakupu aktualizacji. Z kolei przy braku wsparcia pozostaje poprawa kodu przez specjalistę albo wymiana dodatku na kompatybilny odpowiednik.

Na końcu trzeba wyczyścić cache i sprawdzić kluczowe funkcje sklepu: koszyk, płatności oraz widoczność podstawowych elementów SEO.

Cofnięcie aktualizacji i przywrócenie kopii zapasowej

Jeżeli problemy nie dają się szybko usunąć, cofnięcie zmian zwykle oznacza przywrócenie backupu wykonanego przed wdrożeniem. Taka kopia zapasowa musi obejmować pliki sklepu i bazę danych, bo dopiero komplet pozwala odtworzyć działające środowisko na tym samym serwerze lub w lokalizacji zastępczej.

Przy większym sklepie kopia zapasowa i jej przywracanie mogą oznaczać kilkadziesiąt minut niedostępności, dlatego warto sprawdzić przed wdrożeniem, ile czasu zajmuje realne odtworzenie.

Krok, który często się pomija, to test backupu przed pracami. Niezweryfikowana kopia zapasowa PrestaShop nie daje pewności, że dane da się odzyskać, więc PRODO zaleca próbne odtworzenie na środowisku testowym zanim rozpocznie się aktualizacja sklepu.