Biały ekran PrestaShop – jak naprawić WSOD?
Biały ekran (White Screen of Death) to jeden z najczęstszych problemów w PrestaShop. Sklep przestaje działać bez żadnego komunikatu błędu. Sprawdź jak go naprawić krok po kroku.
Czym jest biały ekran w PrestaShop?
Biały ekran (WSOD – White Screen of Death) oznacza, że PHP napotkało krytyczny błąd i nie może wyświetlić strony. Zamiast treści widzisz pustą, białą stronę – bez żadnego komunikatu.
Najczęstsze przyczyny
- Błąd składni PHP w module lub overridzie
- Wyczerpanie limitu pamięci PHP (memory_limit)
- Konflikt po instalacji lub aktualizacji modułu
- Uszkodzony plik .htaccess
- Błąd po aktualizacji PrestaShop
Krok 1 – włącz tryb debugowania
Edytuj plik config/defines.inc.php i znajdź linię:
define('_PS_MODE_DEV_', false);Zmień na:
define('_PS_MODE_DEV_', true);Teraz zamiast białego ekranu zobaczysz konkretny komunikat błędu PHP.
false – tryb deweloperski nie powinien działać na produkcji.
Krok 2 – sprawdź logi błędów
Logi PHP znajdziesz w:
var/logs/– logi PrestaShop- Panel hostingu → Logi błędów PHP
- Plesk → Domains → prestashop → Logs
Krok 3 – wyłącz ostatnio zainstalowany moduł
Jeśli biały ekran pojawił się po instalacji modułu – wyłącz go przez FTP. Przejdź do katalogu modules/ i zmień nazwę folderu problematycznego modułu np. z supermodul na supermodul_OFF.
Krok 4 – sprawdź memory_limit
W pliku .htaccess dodaj:
php_value memory_limit 256MLub w php.ini:
memory_limit = 256MKrok 5 – wyczyść cache PrestaShop
Usuń zawartość katalogów przez FTP:
var/cache/dev/
var/cache/prod/