Przejdź do treści
Darmowy audyt

Sklepy internetowe Problem i rozwiązanie

Aktualizacja PrestaShop: moduły przestały działać - co zrobić i jak aktualizować bezpiecznie

Autor: Bartosz Gromek Zaktualizowano: 6 min czytania

W skrócie

  • Objaw: po aktualizacji PrestaShop sklep pokazuje błąd 500 albo biały ekran, panel się nie ładuje, znikają metody płatności lub dostawy, a szablon się rozjeżdża.
  • Przyczyna: nowa wersja zmienia wymagania (PHP, Symfony, szablony), a moduły, nadpisania klas rdzenia (override) i szablon pisane pod starszą wersję korzystają z elementów, które się zmieniły albo zniknęły.
  • Rozwiązanie: przywróć kopię i włącz tryb konserwacji, a aktualizację powtórz na kopii testowej: lista modułów i nadpisań, sprawdzenie zgodności u autorów, właściwa wersja PHP, asystent aktualizacji z kopią zapasową i test całej ścieżki zakupu.

Nie masz czasu? Zrobimy to za Ciebie - Sklepy internetowe od 3 500 zł netto

Po aktualizacji PrestaShop moduły przestają działać, bo nowa wersja zmienia fundamenty sklepu: wymagane wersje PHP, framework Symfony i sposób działania szablonów, a moduły, nadpisania klas rdzenia (override) i szablon pisane pod starszą wersję korzystają z elementów, które się zmieniły. Jeśli sklep po aktualizacji nie działa, przywróć kopię zapasową, a aktualizację powtórz na kopii testowej z listą zgodności modułów. PrestaShop 9.0 z czerwca 2025 r. to wydanie główne oparte na Symfony 6.4 i producent sam uprzedza, że część modułów i szablonów będzie wymagała aktualizacji.

Jak wygląda problem?

  • błąd 500 albo biały ekran na stronie sklepu lub w panelu,
  • moduł płatności albo przewoźnika zniknął z zamówienia,
  • szablon wyświetla się bez stylów albo z błędami na karcie produktu,
  • komunikat o niezgodnym module albo brakującej klasie,
  • integracja z hurtownią, BaseLinkerem lub programem księgowym przestała wymieniać dane.

Dlaczego moduły przestają działać po aktualizacji?

Wydanie główne zmienia fundamenty

Przejście między wydaniami głównymi (1.7, 8, 9) to nie drobna poprawka. PrestaShop 8 korzystał z Symfony 4.4, a PrestaShop 9 z Symfony 6.4, co zmienia sposób działania panelu i części interfejsów, z których korzystają moduły. Moduł, który nie został dostosowany przez autora, może przestać działać w całości albo tylko w jednym miejscu, np. na stronie konfiguracji.

Nowe wymagania PHP

Gałąź 8.x działa na PHP od 7.2 do 8.1, a PrestaShop 9.0 na PHP od 8.1 do 8.4. Zmiana PHP na serwerze przy okazji aktualizacji ujawnia błędy w starym kodzie modułów, który działał tylko na starszych wersjach języka.

Nadpisania klas rdzenia (override)

Część modułów i zmian zamawianych u programistów nadpisuje klasy rdzenia PrestaShop zamiast korzystać z punktów zaczepienia (hooków). Po aktualizacji rdzeń się zmienia, a nadpisanie zostaje w starej wersji i psuje działanie sklepu albo blokuje samą aktualizację. To najczęstsza przyczyna problemów w sklepach rozwijanych latami.

Moduły bez wsparcia

Moduł kupiony lata temu mógł przestać być rozwijany albo jego licencja na aktualizacje wygasła. Wtedy nie ma wersji zgodnej z nową PrestaShop i trzeba go zastąpić albo przepisać.

Szablon i cache

Szablon dostosowany do starszej wersji nie zna nowych elementów stron, a stare pliki w cache sklepu potrafią po aktualizacji wyświetlać nieaktualne szablony lub błędy. W PrestaShop 9.1 domyślnym szablonem jest Hummingbird 2.0, ale sklep z własnym szablonem nie dostanie go automatycznie, więc trzeba sprawdzić, czy obecny szablon jest zgodny.

Co zrobić, gdy sklep po aktualizacji nie działa?

  1. Włącz tryb konserwacji, żeby klienci nie składali zamówień w niedziałającym sklepie.
  2. Jeśli masz kopię sprzed aktualizacji, przywróć ją. Asystent aktualizacji PrestaShop (dawniej 1-Click Upgrade) robi kopię i pozwala przywrócić sklep.
  3. Jeśli musisz naprawiać na miejscu, włącz na chwilę tryb debugowania albo sprawdź log błędów PHP, żeby zobaczyć, który moduł lub plik powoduje błąd.
  4. Wyłącz problematyczny moduł (w panelu albo przez zmianę nazwy jego folderu na serwerze) i wyczyść cache sklepu.
  5. Sprawdź płatności, dostawę i maile złożeniem zamówienia testowego, zanim wyłączysz tryb konserwacji.

Jak bezpiecznie zaktualizować PrestaShop?

Na kopii testowej, z pełną listą modułów i nadpisań, po sprawdzeniu zgodności u ich autorów i z kopią zapasową, którą umiesz przywrócić.

Wersja PrestaShop Obsługiwane PHP Uwagi
8.0 - 8.2 7.2 - 8.1 (zalecane 8.1) PHP 8.1 nie dostaje już poprawek bezpieczeństwa
9.0 8.1 - 8.4 Wydanie główne z czerwca 2025 r., Symfony 6.4
9.1 od 8.1, zalecane 8.5 Nowy domyślny szablon Hummingbird 2.0
  • spisz wszystkie moduły (z wersją i autorem) oraz nadpisania w katalogu override,
  • sprawdź u autorów, czy mają wersje zgodne z docelową PrestaShop, i odnów licencje na aktualizacje,
  • moduły bez wsparcia zastąp innymi albo przepisz, a nadpisania przenieś do hooków,
  • zrób aktualizację na kopii testowej z docelową wersją PHP i przetestuj ścieżkę zakupu, panel i integracje,
  • na działającym sklepie aktualizuj poza godzinami sprzedaży, z kopią zapasową i planem powrotu,
  • wydania poprawkowe z poprawkami bezpieczeństwa instaluj bez zwłoki, bo dotyczą znanych luk.

Aktualizować czy migrować?

Jeśli sklep jest na gałęzi 8.x i ma kilka modułów od znanych autorów, aktualizacja do 9 jest zwykle rozsądniejsza niż przenosiny. Jeśli sklep stoi na 1.7, ma wiele nadpisań, moduły bez wsparcia i szablon, którego nikt nie rozwija, aktualizacja oznacza przepisanie dużej części sklepu. Wtedy porównaj jej koszt z migracją na inną platformę, na przykład WooCommerce, i uwzględnij, kto będzie utrzymywał sklep przez kolejne lata. Jeśli dodatkowo sklep działa wolno, zobacz wpis PrestaShop działa wolno.

Nie aktualizuj działającego sklepu bez kopii zapasowej plików i bazy, którą umiesz przywrócić. Kopia, której nikt nigdy nie przywracał, to tylko nadzieja na kopię.

Jeśli zamiast kolejnej aktualizacji wolisz przenieść sklep na platformę, którą łatwiej utrzymać, zobacz, jak przeprowadzamy migrację sklepu internetowego. Ten problem jest jednym z naszej listy 50 problemów z PrestaShop i Shoperem.

Darmowy skan sklepu

Sprawdź swój sklep za darmo

Wpisz adres, a przeniesiemy Cię do bezpłatnego skanu na stronie CodeScriptum.

Jak to rozwiązać krok po kroku

Aktualizacja PrestaShop: moduły przestały działać - co zrobić i jak aktualizować bezpiecznie - https://codescriptum.pl/blog/aktualizacja-prestashop-moduly-przestaly-dzialac/

  1. Włącz tryb konserwacji i przywróć kopię sprzed aktualizacji albo, jeśli jej nie ma, znajdź w logu błędów moduł lub plik, który powoduje awarię, i wyłącz go.
  2. Spisz wszystkie moduły z wersją i autorem oraz pliki w katalogu override, a przy każdym zapisz, czy autor ma wersję zgodną z docelową PrestaShop.
  3. Przygotuj kopię testową sklepu z wersją PHP wymaganą przez docelową PrestaShop.
  4. Zastąp lub przepisz moduły bez wsparcia, a nadpisania klas rdzenia przenieś do hooków.
  5. Wykonaj aktualizację na kopii testowej asystentem aktualizacji z kopią zapasową i przetestuj panel, ścieżkę zakupu, płatności, dostawę, maile i integracje.
  6. Zaktualizuj działający sklep poza godzinami sprzedaży, z gotowym planem powrotu, i złóż zamówienie testowe przed wyłączeniem trybu konserwacji.

Jak sprawdzić, że zadziałało

Panel i sklep działają bez błędów w logu PHP, wszystkie metody płatności i dostawy są dostępne w zamówieniu, maile dochodzą, a integracje wymieniają dane. Zamówienie testowe przechodzi od koszyka do dokumentu sprzedaży, a sklep działa na wersji PHP obsługiwanej przez producenta.

Usługa CodeScriptum

Sklepy internetowe

od 3 500 zł netto

  • WooCommerce, Shopify, PrestaShop, Shoper i sklepy dedykowane
  • Migracja bez utraty pozycji w Google
  • Integracje: płatności, InPost, BaseLinker, KSeF

Najczęściej zadawane pytania

Czy da się zaktualizować PrestaShop bez ryzyka?

Ryzyko zawsze jest, ale da się je ograniczyć: aktualizacja najpierw na kopii testowej, lista zgodności modułów, kopia zapasowa, którą umiesz przywrócić, i aktualizacja działającego sklepu poza godzinami sprzedaży.

Co to jest override w PrestaShop i dlaczego psuje aktualizacje?

Override to nadpisanie klasy rdzenia przez moduł lub własny kod. Po aktualizacji rdzeń się zmienia, a nadpisanie zostaje w starej wersji, co powoduje błędy. Bezpieczniej jest korzystać z hooków.

Czy warto zostać na PrestaShop 8?

Gałąź 8.x obsługuje PHP najwyżej 8.1, które nie dostaje już poprawek bezpieczeństwa. Pozostanie na niej oznacza coraz większe ryzyko po stronie serwera, dlatego warto zaplanować przejście na 9 albo migrację.

Kiedy zamiast aktualizacji lepsza jest migracja?

Gdy aktualizacja wymaga przepisania większości modułów i szablonu, a koszt utrzymania sklepu na PrestaShop przez kolejne lata jest wyższy niż koszt przeniesienia na platformę, którą łatwiej rozwijać.

Źródła

  1. PrestaShop: PrestaShop 9.0 is available (build.prestashop-project.org) (otwiera się w nowej karcie) build.prestashop-project.org
  2. PrestaShop: PrestaShop 9.1 is available (build.prestashop-project.org) (otwiera się w nowej karcie) build.prestashop-project.org
  3. PrestaShop 9: wymagania systemowe (dokumentacja) (otwiera się w nowej karcie) devdocs.prestashop-project.org
  4. PrestaShop 8: wymagania systemowe (dokumentacja) (otwiera się w nowej karcie) devdocs.prestashop-project.org
  5. PHP: wspierane wersje (otwiera się w nowej karcie) php.net

Podobne problemy

O autorze

Bartosz Gromek

Założyciel CodeScriptum, technologia i rozwój

Założyciel CodeScriptum - firmy technologicznej z Łodzi, działającej od 2022 roku. Odpowiada za technologię i rozwój, a projekty realizuje razem z zespołem specjalistów od stron, sklepów internetowych, systemów CRM, integracji, AI i marketingu. Na blogu opisuje problemy, z którymi zgłaszają się klienci CodeScriptum, i sprawdzone sposoby ich rozwiązania.

Newsletter

Konkretne porady raz na jakiś czas

Nowe problemy i rozwiązania z bloga, zmiany w przepisach dla sklepów i stron oraz sprawdzone sposoby na więcej klientów z internetu. Bez spamu, wypis jednym kliknięciem.