Sklepy internetowe Problem i rozwiązanie
Aktualizacja PrestaShop: moduły przestały działać - co zrobić i jak aktualizować bezpiecznie
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?
- Włącz tryb konserwacji, żeby klienci nie składali zamówień w niedziałającym sklepie.
- Jeśli masz kopię sprzed aktualizacji, przywróć ją. Asystent aktualizacji PrestaShop (dawniej 1-Click Upgrade) robi kopię i pozwala przywrócić sklep.
- 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.
- Wyłącz problematyczny moduł (w panelu albo przez zmianę nazwy jego folderu na serwerze) i wyczyść cache sklepu.
- 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/
- 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.
- 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.
- Przygotuj kopię testową sklepu z wersją PHP wymaganą przez docelową PrestaShop.
- Zastąp lub przepisz moduły bez wsparcia, a nadpisania klas rdzenia przenieś do hooków.
- Wykonaj aktualizację na kopii testowej asystentem aktualizacji z kopią zapasową i przetestuj panel, ścieżkę zakupu, płatności, dostawę, maile i integracje.
- 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
- PrestaShop: PrestaShop 9.0 is available (build.prestashop-project.org) (otwiera się w nowej karcie) build.prestashop-project.org
- PrestaShop: PrestaShop 9.1 is available (build.prestashop-project.org) (otwiera się w nowej karcie) build.prestashop-project.org
- PrestaShop 9: wymagania systemowe (dokumentacja) (otwiera się w nowej karcie) devdocs.prestashop-project.org
- PrestaShop 8: wymagania systemowe (dokumentacja) (otwiera się w nowej karcie) devdocs.prestashop-project.org
- PHP: wspierane wersje (otwiera się w nowej karcie) php.net
Podobne problemy
Sklepy internetowe
Problemy z PrestaShop i Shoperem: 50 problemów, co naprawić i kiedy migrować (2026)
Przy każdym z 50 problemów podajemy przyczynę i rozwiązanie; budujemy i utrzymujemy sklepy na obu platformach, a jeśli migracja jest lepsza od łatania, przeniesiemy sklep za…
Sklepy internetowe
PrestaShop działa wolno - przyczyny, naprawa i kiedy lepsza jest migracja
Rozwiązanie Zmierz czas odpowiedzi serwera, popraw ustawienia wydajności, PHP i cache, wyłącz zbędne moduły i oczyść bazę na kopii sklepu. Migracja ma sens, gdy sklep stoi na…
Sklepy internetowe
Migracja sklepu internetowego: 50 problemów i jak ich uniknąć (2026)
Przy każdym z 50 problemów podajemy najczęstszą przyczynę i konkretne rozwiązanie; jeśli wolisz oddać migrację zespołowi, który robi to na co dzień, przeprowadzimy ją za Ciebie.
Sklepy internetowe
Kiedy WooCommerce przestaje wystarczać - sygnały, co sprawdzić najpierw i jakie są opcje
Rozwiązanie Najpierw usuń wąskie gardła (hosting, HPOS, wtyczki), a gdy to nie wystarcza, zastąp zestaw wtyczek własnymi modułami, rozważ oddzielenie frontu (headless) albo sklep…