Bílá stránka ve WordPressu: přečtěte si chybu dřív, než na web sáhnete

„Závažná chyba“ nebo bílá stránka: stejná porucha

Bílá stránka je nejčastěji fatální chyba PHP: soubor webu požadoval něco nemožného a běh se zastavil dřív, než cokoli zobrazil. Od verze 5.2 WordPress tyto chyby zachytává: místo prázdné stránky zobrazí „Na webu došlo k závažné chybě.“ a pošle e-mail na e-mailovou adresu administrátora webu.

Stránka zůstane úplně bílá jen v několika případech: starší verze WordPressu, chyba vzniklá před načtením tohoto mechanismu, konstanta WP_DISABLE_FATAL_ERROR_HANDLER nastavená na true nebo plugin pro cache, který servíruje prázdnou stránku uloženou během poruchy. Postup, který následuje, platí pro všechny tyto případy.

Tři kroky mohou počkat, až si chybu přečtete: přeinstalace WordPressu, mazání pluginů, obnova staré zálohy. Každý z nich může smazat nastavení nebo nedávná data, zatímco chybové hlášení obvykle řekne, kterou součást deaktivovat, a to bez jakékoli ztráty.

Zkratka: režim obnovení

Když WordPress chybu zachytí, pošle na e-mailovou adresu administrátora webu zprávu s předmětem „[Název webu] Web má technické potíže“. Zpráva jmenuje plugin nebo šablonu, která chybu způsobuje, a obsahuje odkaz, který otevře administraci v režimu obnovení.

• V tomto režimu je vadná součást pozastavena jen pro vás: návštěvníci chybu vidí dál.
• V nabídce Pluginy nebo Vzhled > Šablony deaktivujte označenou součást a pak v horní liště administrace klikněte na „Ukončit režim obnovení“.
• Odkaz platí 24 hodin a WordPress takový e-mail pošle nejvýše jednou denně. Pokud e-mail nepřijde, podívejte se do složky se spamem a pak přejděte k další metodě.

Přečíst chybu: ladicí log

Připojte se k webu přes SFTP nebo správcem souborů u poskytovatele hostingu, otevřete wp-config.php v kořenovém adresáři a řádek define( 'WP_DEBUG', false ); nahraďte těmito čtyřmi řádky:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Vložte je nad komentář, který uzavírá upravitelnou část souboru (/* That's all, stop editing! Happy publishing. */, který WordPress v češtině ponechává v angličtině). Znovu načtěte stránku s chybou a otevřete wp-content/debug.log. WP_DEBUG_DISPLAY nastavené na false drží hlášení v souboru, mimo stránku, kterou vidí návštěvníci.

Pokud debug.log zůstane prázdný nebo se neobjeví, zapsalo chybu přímo PHP: hledejte soubor error_log v kořeni webu nebo ve wp-admin, případně sekci chybových logů v panelu poskytovatele hostingu.

Co hlášení říká a jaký krok k němu patří

Fatální chyba se vejde na jeden řádek: typ chyby, její popis, pak in a za ním úplná cesta k souboru a číslo řádku. Cesta je nejužitečnější informace: wp-content/plugins/nazev/ označuje plugin, wp-content/themes/nazev/ šablonu.

define( 'WP_MEMORY_LIMIT', '256M' );

Deaktivovat vadnou součást bez administrace

Přes SFTP nebo správce souborů

Přejmenujte složku pluginu uvedeného v hlášení, například wp-content/plugins/nazev-pluginu na nazev-pluginu.off. WordPress plugin nenajde a přestane ho načítat; jeho nastavení zůstává uložené v databázi a WordPress ho deaktivuje při příštím otevření obrazovky pluginů.

U šablony zpřístupní přejmenování její složky ve wp-content/themes znovu administraci, ale návštěvníci vidí prázdnou stránku, dokud není aktivní žádná šablona. Hned otevřete Vzhled > Šablony: WordPress zjistí, že aktivní šablona je poškozená, a přepne na nainstalovanou výchozí šablonu.

Přes WP-CLI

wp plugin list --status=active
wp plugin deactivate nazev-pluginu
wp theme list
wp theme activate twentytwentyfive

První příkaz vypíše seznam aktivních pluginů, který se hodí uschovat před jakoukoli hromadnou deaktivací. Pokud se WP-CLI sám zastaví na chybě, přidejte k příkazu --skip-plugins --skip-themes: spustí se pak bez načtení pluginů a šablony. Pluginy ze složky wp-content/mu-plugins se načtou i tak; pokud chyba pochází z některého z nich, přejmenujte jeho soubor.

Když hlášení žádnou součást neoznačuje, wp plugin deactivate --all deaktivuje všechny pluginy. Pokud se web vrátí, aktivujte je znovu jeden po druhém a mezi každým web znovu načtěte: ten, po jehož aktivaci se chyba vrátí, je ten pravý.

Když web znovu funguje

1. Vraťte define( 'WP_DEBUG', false ); a odstraňte WP_DEBUG_LOG z wp-config.php.
2. Smažte wp-content/debug.log: ve složce dostupné z webu si ho může přečíst kdokoli a obsahuje cesty na serveru.
3. Aktualizujte nebo nahraďte vadnou součást a přečtěte si přitom její seznam změn.
4. Vyprázdněte cache pluginu pro cache a cache poskytovatele hostingu, pokud ji má.
5. Pro příště: aktualizace otestujte na kopii webu dřív, než je nasadíte na ostrý web.