PrestaShop błąd 500 (Internal Server Error) oznacza, że skrypt sklepu przerwał działanie, a serwer nie pokazał dlaczego. Najczęściej winny jest moduł po aktualizacji, niezgodna wersja PHP, uszkodzony plik .htaccess albo za niski limit pamięci. Żeby go naprawić, trzeba najpierw zobaczyć prawdziwy komunikat błędu, w trybie debugowania lub w logach serwera, a dopiero potem cokolwiek zmieniać.
W skrócie
- Błąd 500 w PrestaShop to ogólny komunikat serwera, za którym najczęściej stoi niezgodny moduł, zła wersja PHP, uszkodzony plik .htaccess albo za niski limit pamięci.
- PrestaShop 8 działa na PHP od 7.2.5 do 8.1, a PrestaShop 9 wymaga PHP 8.1 lub nowszego i co najmniej 512 MB pamięci na skrypt.
- Prawdziwy komunikat błędu pokaże tryb debugowania, włączany w panelu albo w pliku config/defines.inc.php.
Jeśli sklep stoi i nie masz czasu na szukanie przyczyny, zobacz, jak wygląda pomoc przy awariach PrestaShop w naszej agencji PrestaShop. Poniżej opisujemy, co możesz sprawdzić samodzielnie.
Co oznacza błąd 500 w PrestaShop?
Kod 500 to odpowiedź serwera, a nie komunikat PrestaShop. Serwer mówi nim tylko tyle, że nie udało się wygenerować strony. Powód jest ukryty celowo: na działającym sklepie szczegóły błędów nie powinny być widoczne dla klientów.
Błąd może dotyczyć całego sklepu, samego panelu administracyjnego albo jednej strony, na przykład koszyka. To ważna wskazówka. Jeśli nie działa tylko koszyk, szukaj w modułach płatności i dostaw. Jeśli nie działa nic, zacznij od wersji PHP, pliku .htaccess i ostatnich zmian na serwerze.
Odmianą tego samego problemu jest biały ekran, czyli pusta strona bez żadnego komunikatu. Przyczyny i sposób diagnozy są takie same.
Jakie są najczęstsze przyczyny błędu 500?
W praktyce powtarza się kilka scenariuszy:
- Moduł po aktualizacji lub instalacji. Nowa wersja modułu nie pasuje do wersji sklepu albo kłóci się z innym modułem lub nadpisaniem.
- Zmiana wersji PHP na serwerze. Hosting wyłącza stare wersje PHP i przełącza konto na nowszą, której sklep nie obsługuje.
- Uszkodzony plik
.htaccess. Wystarczy jedna błędna reguła, żeby serwer odrzucał każde żądanie. - Za niski limit pamięci lub czasu. Import produktów, generowanie miniatur czy ciężki moduł wyczerpują
memory_limit. - Nieudana aktualizacja sklepu. Proces przerwany w połowie zostawia pliki z dwóch wersji.
- Uprawnienia plików i katalogów zmienione po przeniesieniu sklepu na inny serwer.
- Stara pamięć podręczna po zmianach w kodzie lub modułach.
Jak włączyć tryb debugowania?
Tryb debugowania zamienia ogólny błąd 500 na konkretny komunikat: nazwę pliku, numer linii i opis problemu. Według centrum pomocy PrestaShop są dwa sposoby.
W panelu administracyjnym: wejdź w Zaawansowane > Wydajność, ustaw Tryb debugowania na Tak i zapisz.
Przez FTP (gdy panel też zwraca błąd): otwórz plik /config/defines.inc.php, znajdź stałą _PS_MODE_DEV_ i zmień jej wartość z false na true.
Dwie uwagi. Po pierwsze, przed edycją plików zrób ich kopię. Po drugie, komunikaty błędów w trybie debugowania mogą zobaczyć także klienci, dlatego PrestaShop zaleca włączyć na ten czas tryb konserwacji albo ograniczyć debugowanie do własnego adresu IP. Po znalezieniu przyczyny wyłącz tryb debugowania.
Jeśli tryb debugowania niczego nie pokazuje, zajrzyj do logów błędów PHP w panelu hostingu. Tam trafiają błędy, które zatrzymują skrypt, zanim PrestaShop zdąży cokolwiek wyświetlić.
Błąd 500 po zmianie wersji PHP – jakie wersje obsługuje PrestaShop?
To jedna z najczęstszych przyczyn nagłej awarii sklepu, który „wczoraj działał”. Każde wydanie PrestaShop ma zakres obsługiwanych wersji PHP. Poniżej zestawienie z oficjalnej dokumentacji.
| Wersja PrestaShop | Minimalne PHP | Maksymalne PHP | Zalecane PHP | Min. memory_limit |
|---|---|---|---|---|
| 1.7.0–1.7.4 | 5.4 (1.7.4: 5.6) | 7.1 | 7.1 | – |
| 1.7.5–1.7.6 | 5.6 | 7.2 | 7.2 | – |
| 1.7.7 | 7.1 | 7.3 | 7.3 | – |
| 1.7.8 | 7.1 | 7.4 | 7.4 | – |
| 8.0–8.2 | 7.2.5 | 8.1 | 8.1 | 256 MB |
| 9.0 | 8.1 | 8.4 | 8.4 | 512 MB |
| 9.1–9.2 | 8.1 | 8.5 | 8.5 | 512 MB |
Sklep na PrestaShop 1.7.8 nie uruchomi się na PHP 8, a sklep na PrestaShop 8 nie ruszy na PHP 8.2. Jeśli hosting przełączył wersję PHP, wróć w panelu hostingu do wersji z zakresu dla swojego sklepu. To rozwiązanie doraźne. Stare wersje PHP nie dostają poprawek bezpieczeństwa i dostawcy stopniowo je wyłączają, więc docelowo potrzebna jest aktualizacja PrestaShop do wersji 9.
Jak naprawić błąd po instalacji lub aktualizacji modułu?
Jeśli błąd pojawił się zaraz po zmianie w modułach, komunikat z trybu debugowania zwykle wskazuje katalog winnego modułu. Co można zrobić:
- Wyłącz moduł w panelu, jeśli panel działa.
- Jeśli panel nie działa, zmień przez FTP nazwę katalogu modułu w
/modules/. PrestaShop przestanie go ładować i sklep powinien wstać. - Wyczyść pamięć podręczną w panelu (Zaawansowane > Wydajność) albo usuń zawartość katalogu
var/cache. - Sprawdź wersję modułu. Moduł musi być zgodny z wersją sklepu i wersją PHP. Przy płatnych modułach nowsza wersja często wymaga aktywnej licencji u producenta.
Nie usuwaj modułu płatności ani dostawy bez sprawdzenia, czy masz jego konfigurację i dane dostępowe. Wyłączenie jest odwracalne, usunięcie nie zawsze.
Co sprawdzić w .htaccess i limitach serwera?
Gdy komunikat błędu nie wskazuje modułu, zostają ustawienia serwera.
Plik .htaccess. Zmień jego nazwę przez FTP (np. na .htaccess-kopia) i sprawdź, czy strona główna się otwiera. Jeśli tak, wygeneruj plik od nowa w panelu: Preferencje > Ruch > SEO i adresy URL, zapisując ustawienia przyjaznych adresów.
Limit pamięci. Dokumentacja PrestaShop podaje minimum 256 MB na skrypt dla wersji 8 i 512 MB dla wersji 9. Na tanich hostingach limit bywa niższy i sklep przewraca się przy cięższych operacjach.
Uprawnienia i właściciel plików. Po przeniesieniu sklepu pliki mogą należeć do innego użytkownika serwera, przez co PrestaShop nie zapisze pamięci podręcznej ani logów. Jak tego uniknąć, opisujemy we wpisie o przeniesieniu PrestaShop na inny serwer.
Rozszerzenia PHP. PrestaShop 9 wymaga m.in. rozszerzeń cURL, GD, Intl, Mbstring, PDO MySQL i Zip. Brak jednego z nich po zmianie wersji PHP też kończy się błędem.
Kiedy oddać naprawę specjalistom?
Samodzielna diagnoza ma sens, gdy błąd pojawił się po konkretnej, odwracalnej zmianie: instalacji modułu albo przełączeniu PHP. Warto poprosić o pomoc, gdy:
- nie masz aktualnej kopii zapasowej plików i bazy danych,
- błąd wraca albo pojawia się tylko przy niektórych zamówieniach,
- komunikat wskazuje pliki rdzenia PrestaShop lub nadpisania,
- awaria nastąpiła w trakcie aktualizacji sklepu,
- podejrzewasz włamanie: obce pliki, przekierowania, nieznane konta administratorów.
W Devisu zaczynamy od wstępnej oceny zgłoszenia, podajemy zakres i koszt, a prace wykonujemy po kopii zapasowej. Rozliczamy czas pracy: 120 zł netto za godzinę. Jeśli błędy wynikają z przestarzałej wersji sklepu, policzymy też przejście na wersję 9. Orientacyjny koszt nowego sklepu sprawdzisz w interaktywnej wycenie.
Jak zapobiegać błędom 500 w przyszłości?
Większości awarii da się uniknąć kilkoma nawykami:
- Kopia zapasowa przed każdą zmianą: plików i bazy danych, przechowywana poza serwerem sklepu.
- Aktualizacje najpierw na kopii sklepu. Moduł lub nową wersję PrestaShop testuj na serwerze testowym, razem z całym procesem zamówienia.
- Kontrola wersji PHP. Sprawdź w panelu hostingu, kiedy dostawca planuje wyłączyć Twoją wersję, i zaplanuj aktualizację sklepu wcześniej.
- Mniej modułów. Każdy nieużywany moduł to dodatkowy kod, który może przestać działać po aktualizacji. Nadmiar modułów także spowalnia sklep. Więcej we wpisie o tym, co spowalnia sklep PrestaShop.
- Zmiany w modułach i motywie potomnym, a nie w plikach rdzenia. Dzięki temu kolejne aktualizacje ich nie nadpisują.
Najczęściej zadawane pytania (FAQ)
To ogólny komunikat serwera: skrypt sklepu przerwał działanie, ale serwer nie pokazuje powodu. Przyczyną bywa błąd w module, niezgodna wersja PHP, uszkodzony plik .htaccess albo wyczerpany limit pamięci. Dokładny komunikat zobaczysz po włączeniu trybu debugowania lub w logach serwera.
W panelu wejdź w Zaawansowane > Wydajność i ustaw Tryb debugowania na Tak. Jeśli panel też nie działa, otwórz przez FTP plik config/defines.inc.php i zmień wartość stałej _PS_MODE_DEV_ z false na true. Po znalezieniu przyczyny wyłącz tryb, bo komunikaty błędów mogą być widoczne dla klientów.
Każda wersja PrestaShop działa tylko w określonym zakresie wersji PHP. PrestaShop 1.7.8 obsługuje PHP najwyżej 7.4, a PrestaShop 8 najwyżej 8.1, więc przełączenie serwera na nowsze PHP zatrzymuje sklep. Rozwiązaniem doraźnym jest powrót do obsługiwanej wersji, a trwałym aktualizacja sklepu.
Sam komunikat niczego nie usuwa. To objaw, a nie przyczyna. Ryzyko pojawia się przy naprawianiu na ślepo, na przykład przy usuwaniu plików lub tabel bez kopii zapasowej. Dlatego przed każdą zmianą warto zrobić kopię plików i bazy danych.
To zależy od przyczyny: wyłączenie wadliwego modułu trwa krótko, a dostosowanie sklepu do nowej wersji PHP może wymagać aktualizacji. W Devisu rozliczamy czas pracy, 120 zł netto za godzinę, a zakres i koszt podajemy przed rozpoczęciem prac.











