Biela stránka vo WordPresse: prečítajte si chybu skôr, než sa dotknete webu

„Kritická chyba“ alebo biela stránka: tá istá porucha

Biela stránka je najčastejšie fatálna chyba PHP: niektorý súbor webu požiadal o niečo nemožné a vykonávanie sa zastavilo skôr, než sa čokoľvek zobrazilo. Od verzie 5.2 WordPress tieto chyby zachytáva: namiesto prázdnej stránky zobrazí „Na vašej web stránke sa vyskytla kritická chyba.“ a pošle e-mail na administrátorskú adresu webu.

Stránka zostane úplne biela v niekoľkých prípadoch: staršia verzia WordPressu, chyba, ktorá nastala pred načítaním tohto mechanizmu, konštanta WP_DISABLE_FATAL_ERROR_HANDLER nastavená na true alebo plugin pre cache, ktorý servíruje prázdnu stránku uloženú počas poruchy. Postup, ktorý nasleduje, platí pre všetky tieto prípady.

Tri kroky môžu počkať, kým si chybu prečítate: preinštalovanie WordPressu, mazanie pluginov, obnovenie starej zálohy. Každý z nich môže vymazať nedávne nastavenia alebo údaje, zatiaľ čo hlásenie o chybe zvyčajne povie, ktorú súčasť deaktivovať, a všetko ostatné zostane zachované.

Skratka: mód obnovy

Keď WordPress chybu zachytí, pošle na administrátorskú e-mailovú adresu webu správu s predmetom „[Názov webu] Vaša stránka má v tejto chvíli technické problémy“. Pomenúva plugin alebo tému, v ktorej chyba vznikla, a obsahuje odkaz, ktorý otvorí administráciu v móde obnovy.

• V tomto móde je chybná súčasť pozastavená len pre vás: vaši návštevníci chybu vidia naďalej.
• V ponuke Pluginy alebo Vzhľad > Témy deaktivujte označenú súčasť a potom na paneli nástrojov administrácie kliknite na „Opustiť mód obnovy“.
• Odkaz platí 24 hodín a WordPress pošle najviac jeden takýto e-mail denne. Ak e-mail nepríde, pozrite sa do priečinka spamu a potom prejdite na ďalší postup.

Prečítať chybu: ladiaci log

Pripojte sa k webu cez SFTP alebo cez správcu súborov svojho poskytovateľa hostingu, otvorte wp-config.php v koreňovom adresári a riadok define( 'WP_DEBUG', false ); nahraďte týmito štyrmi riadkami:

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

Patria nad komentár, ktorý uzatvára upraviteľnú časť súboru (/* That's all, stop editing! Happy publishing. */, ktorý WordPress v slovenčine ponecháva v angličtine). Znova načítajte stránku s chybou a otvorte wp-content/debug.log. WP_DEBUG_DISPLAY nastavené na false drží hlásenia v súbore, mimo stránky, ktorú vidia vaši návštevníci.

Ak debug.log zostane prázdny alebo sa neobjaví, chybu zapísalo priamo PHP: hľadajte súbor error_log v koreňovom adresári webu alebo v wp-admin, alebo časť s chybovými logmi v paneli poskytovateľa hostingu.

Čo hovorí hlásenie a aký krok k nemu patrí

Fatálna chyba sa zmestí do jedného riadku: typ chyby, jej opis, potom in a za ním úplná cesta k súboru a číslo riadku. Cesta je najužitočnejší údaj: wp-content/plugins/nazov/ označuje plugin, wp-content/themes/nazov/ tému.

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

Deaktivovať chybnú súčasť bez administrácie

Cez SFTP alebo správcu súborov

Premenujte priečinok pluginu, ktorý hlásenie uvádza, napríklad wp-content/plugins/nazov-pluginu na nazov-pluginu.off. WordPress plugin nenájde a prestane ho načítavať; jeho nastavenia zostávajú uložené v databáze a WordPress ho deaktivuje pri najbližšom otvorení obrazovky pluginov.

Pri téme premenovanie jej priečinka v wp-content/themes znova sprístupní administráciu, ale návštevníci vidia prázdnu stránku, kým nie je aktívna nijaká téma. Hneď otvorte Vzhľad > Témy: WordPress zistí, že aktívna téma je poškodená, a vráti sa k nainštalovanej predvolenej téme.

Cez WP-CLI

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

Prvý príkaz zachová zoznam aktívnych pluginov, užitočný pred hromadnou deaktiváciou. Ak sa na chybe zastaví samotné WP-CLI, pridajte k príkazu --skip-plugins --skip-themes: spustí sa potom bez načítania pluginov a témy. Pluginy z priečinka wp-content/mu-plugins sa načítajú aj tak; ak chyba pochádza z niektorého z nich, premenujte jeho súbor.

Keď hlásenie neoznačuje konkrétnu súčasť, wp plugin deactivate --all deaktivuje všetky pluginy. Ak sa web vráti, aktivujte ich znova jeden po druhom a po každom web znova načítajte: plugin aktivovaný naposledy pred návratom chyby je ten pravý.

Keď sa web vráti

1. Vráťte define( 'WP_DEBUG', false ); a odstráňte WP_DEBUG_LOG z wp-config.php.
2. Zmažte wp-content/debug.log: v priečinku dostupnom z webu si ho môže prečítať ktokoľvek a obsahuje cesty na serveri.
3. Aktualizujte alebo nahraďte chybnú súčasť a prečítajte si pritom jej zoznam zmien.
4. Vyprázdnite cache pluginu pre cache aj cache poskytovateľa hostingu, ak ju má.
5. Nabudúce: aktualizácie otestujte na kópii webu skôr, než ich použijete naživo.