Chyba 500 nebo bílá obrazovka v PrestaShopu: co dělat hned teď

V pondělí ráno otevřete e-shop a vidíte jen „Error 500“ nebo úplně prázdnou stránku, zatímco víkendové objednávky čekají. Chyba 500 nebo bílá obrazovka v PrestaShopu skoro nikdy neznamená, že jste o e-shop přišli: znamená, že v zákulisí něco selhalo a PrestaShop vám neumí říct co. Nejdřív na nic nesahejte naslepo; pak to buď diagnostikujte podle kroků níže, nebo problém předejte někomu, kdo se do něj pustí za méně než 12 hodin.

Co znamená chyba 500 v PrestaShopu?

Je to obecná zpráva serveru: „něco se pokazilo a stránku nedokážu dokončit“. Neříká co. Bílá obrazovka je totéž, jen bez té zprávy: e-shop je nastavený tak, aby zákazníkům chyby neukazoval, a tak neukáže vůbec nic.

Dobrá zpráva je, že vaše produkty, zákazníci a objednávky jsou pořád v databázi. Rozbitá je část, která je zobrazuje, a ta se dá opravit.

Proč můj e-shop najednou spadl?

Skoro vždycky se těsně předtím něco změnilo. Nejčastější příčiny jsou:

• Nový nebo aktualizovaný modul, který se pere s jiným nebo s vaší verzí PrestaShopu.
• Aktualizace PrestaShopu nebo šablony, která proběhla jen napůl.
• Změna na hostingu: poskytovatel zvýšil verzi PHP (jazyka, ve kterém PrestaShop běží) a váš e-shop s novou není kompatibilní.
• Mezipaměť, dočasné soubory, které si PrestaShop drží, aby běžel rychleji, zastarala nebo se poškodila.
• Serveru dojde paměť na nejtěžších stránkách, jako je katalog nebo administrace.
• Oprávnění souborů špatně nastavená po přesunu e-shopu nebo po nahrání něčeho přes FTP.

Než uděláte cokoli dalšího, vzpomeňte si: co se v posledních dnech instalovalo, aktualizovalo nebo měnilo? Tahle odpověď ušetří polovinu práce.

Co udělat hned, abych to nezhoršil?

1. Nepřeinstalovávejte PrestaShop a nezačínejte mazat moduly nazdařbůh. Odinstalování modulu může smazat jeho nastavení i data.
2. Požádejte poskytovatele hostingu o zálohu souborů a databáze přesně v tom stavu, v jakém jsou teď, nebo si ji udělejte sami v jeho ovládacím panelu. Každý pokus se tak dá vrátit.
3. Zjistěte, jestli selhává všechno, nebo jen část. Úvodní stránka, jen košík, jen administrace? Zapište si to: je to první stopa.
4. Udělejte snímek obrazovky toho, co vidíte, s viditelnou adresou stránky.

Jak za bílou obrazovkou uvidím skutečnou chybu?

PrestaShop má ladicí režim, který místo prázdné stránky ukáže celou chybovou zprávu. Ta obvykle řekne, který soubor nebo který modul selhal.

Pokud se administrace ještě otevře, zapněte ho v Nástroje > Výkon > Režim ladění. Pokud se neotevře ani ta, musí se to udělat úpravou souboru přes FTP; vysvětlujeme to v poslední části pro váš technický tým.

Důležité upozornění: se zapnutým ladicím režimem vidí chyby i vaši zákazníci. Používejte ho jen tak dlouho, než si zprávu přečtete, a pak ho zase vypněte.

Další zdroj stop je log chyb: PrestaShop ukládá chyby do složky var/logs vašeho e-shopu a hosting má obvykle v ovládacím panelu vlastní log chyb PHP.

Zvládnu to opravit sám, i když neumím programovat?

Někdy ano. Jsou tři kontroly, které zvládnete bez sahání do kódu:

Vymažte mezipaměť

V administraci v Nástroje > Výkon klikněte na Vyčistit mezipaměť. Pokud se administrace neotevře, váš technický tým ji vymaže smazáním obsahu jedné složky. Je to bezpečné: PrestaShop si ty soubory znovu vytvoří sám.

Vypněte modul, na který jste sahali naposledy

Pokud problém začal po instalaci nebo aktualizaci modulu, vypněte ho (neodinstalovávejte) v Moduly > Správce modulů. Pokud se e-shop vrátí, víte, kdo byl viník.

Zeptejte se poskytovatele hostingu, jestli se něco změnilo

Jedna přímá otázka: „Změnili jste v posledních dnech verzi PHP nebo nějaký limit serveru?“ Každá verze PrestaShopu funguje jen s určitými verzemi PHP a taková změna může e-shop shodit přes noc.

Pokud je to i potom pořád stejné, přestaňte zkoušet. Každý pokus naslepo znamená víc času se zavřeným e-shopem a víc rizika, že sáhnete na něco, co ve skutečnosti fungovalo.

Kolik stojí oprava?

V BK Modules nabízíme urgentní technickou podporu pro PrestaShop: zaplatíte jednu hodinu práce technika, 45 € (sazba k říjnu 2026), a pustíme se do toho. Pracujeme 7 dní v týdnu. Chyby 500, bílé obrazovky a administrace, která se neotevře, jsou úplně nahoře na seznamu toho, co opravujeme.

Funguje to takhle:

1. Zaplatíte hodinu. Můžete nám napsat, co vidíte, adresu e-shopu a přiložit snímky obrazovky nebo log chyb, ale je to nepovinné: k zaplacení nemusíte nic vysvětlovat.
2. Technik vám napíše za méně než 12 hodin, 7 dní v týdnu, s tím, co vidíme a jak to opravíme. V tu chvíli vás požádáme o přístup do e-shopu a v případě potřeby k hostingu, bezpečným kanálem. Nikdy ve formuláři.
3. Pokud se to vyřeší během té hodiny, máte hotovo. Pokud je potřeba víc, zastavíme se a řekneme vám, co zbývá a jak dlouho to bude trvat. Rozhodnete, jestli pokračujeme; bez vašeho souhlasu se nic neúčtuje.

Pracujeme s PrestaShopem 1.6, 1.7, 8 i 9 a fakturu máte v účtu hned po zaplacení. Jsme ti, kdo moduly pro PrestaShop vyvíjejí, takže zevnitř víme, co se obvykle rozbíjí.

Jak zabránit, aby se to opakovalo?

Většina těchto chyb pochází z aktualizace nasazené bez testu nebo ze změny na serveru, o které vás nikdo nevaroval. Mít někoho, kdo váš e-shop zná a aktualizace před nasazením testuje, předejde skoro všem takovým lekům.

Přesně to je roční údržba PrestaShopu: testované aktualizace, zálohy, monitoring a hodiny během roku pro chvíle, kdy se něco pokazí.

Pro váš technický tým

Pokud se administrace neotevře, ladicí režim se zapne v config/defines.inc.php změnou false na true na tomto řádku:

define('_PS_MODE_DEV_', true);

• Logy: složka e-shopu var/logs/ a log chyb PHP na serveru.
• Mezipaměť: smažte obsah var/cache/prod/ a var/cache/dev/.
• Podezřelý modul bez přístupu do administrace: přejmenujte jeho složku v modules/, aby ho PrestaShop nenačetl.
• Paměť: PHP memory_limit alespoň 256 MB.
• Oprávnění: složky 755 a soubory 644, s var/, img/ a upload/ zapisovatelnými pro uživatele webového serveru.
• PHP: ověřte, že aktivní verze je kompatibilní s nainstalovanou verzí PrestaShopu.

Až skončíte, vraťte _PS_MODE_DEV_ na false.

Chcete, aby se na váš e-shop někdo podíval hned teď?

Každá hodina, kdy je váš e-shop mimo provoz, jsou prodeje, které odcházejí na jiný web. Zaplaťte hodinu a technik, který PrestaShop zná skrz naskrz, vám za méně než 12 hodin napíše, aby ho zase rozjel.

Opravte můj e-shop za 45 €