Chybové logy ve WordPressu: kde najít chybu a co hlášky znamenají
Chybové logy ve WordPressu jsou soubory, do kterých server, WordPress a pluginy zapisují podrobnosti chyb: hlášku, soubor a řádek. Hledejte na třech místech: debug.log ve složce wp-content (po zapnutí zápisu ve wp-config.php), administrace hostingu a WooCommerce → Stav → Logy. Bez nich je oprava chyby hádání.
Autor: Tým TellMyShop. Průvodce pro majitele webů na WordPressu a obchodů na WooCommerce: příčina, ruční oprava a stejná práce v rozhovoru v chatu.
Naposledy aktualizováno: · 5 min čtení
Tři místa, kde hledat
Každé z těchto míst zaznamenává něco jiného. Kontrolujte je v tomto pořadí, od nejsnazšího.
| Místo | Co se tam zapisuje | Jak se tam dostat | Kdo má obvykle přístup |
|---|---|---|---|
| WooCommerce → Stav → Logy, soubor fatal-errors | fatální chyby PHP se souborem a řádkem | Nástěnka, pokud funguje | vy |
| debug.log ve wp-content | chyby, varování a upozornění z WordPressu a pluginů | správce souborů hostingu nebo FTP, po zapnutí zápisu | vy nebo ten, kdo se o web stará |
| Chybový log PHP na serveru | chyby PHP, i když se WordPress vůbec nenačte | administrace hostingu | hosting, někdy vy |
E-shop na WooCommerce má výhodu: log fatal-errors funguje bez prohrabávání souborů. Samo WooCommerce doporučuje začít tam, jak popisuje dokumentace WooCommerce k hledání chybových logů PHP.
Jak zapnout debug.log krok za krokem
Zápis do debug.log se zapíná ve wp-config.php. Tento soubor obsahuje heslo k databázi, takže pracujte na kopii a opatrně. Pokud si nejste jistí, požádejte hosting nebo toho, kdo se o web stará.
- Ve správci souborů hostingu udělejte kopii wp-config.php.
- Otevřete wp-config.php k úpravám a najděte řádek s WP_DEBUG.
- Nastavte WP_DEBUG na true, přidejte WP_DEBUG_LOG nastavené na true a WP_DEBUG_DISPLAY nastavené na false.
- Soubor uložte a zopakujte to, co chybu vyvolává, například otevřete stránku nebo přidejte produkt do košíku.
- Otevřete wp-content/debug.log a přečtěte poslední řádky.
- Až skončíte, nastavte WP_DEBUG zpět na false.
Všechny konstanty a co dělají, popisuje příručka WordPressu k ladění. Krátké vysvětlení samotného souboru je v heslu slovníku GreenGeeks o WP Debug Log.
Soubor debug.log leží ve složce, na kterou se někdy dá dostat z prohlížeče. Nenechávejte zápis zapnutý natrvalo bez potřeby, nebo požádejte hosting, aby přístup k tomuto souboru zablokoval.
Jak číst záznam v logu
Každý záznam má podobný tvar: datum a čas, úroveň chyby, hláška a na konci cesta k souboru a číslo řádku. Nejdůležitější je cesta. Pokud obsahuje wp-content/plugins/nazev-pluginu, viníkem je ten plugin. Pokud wp-content/themes/nazev-sablony, je to šablona.
Úrovně, od nejzávažnější:
- Fatal error: kód se zastavil a stránka nebo její část nefunguje.
- Warning: něco se nepovedlo, ale stránka pokračuje.
- Notice a Deprecated: poznámky pro vývojáře, obvykle bez dopadu na návštěvníky.
Slovníček: pět častých hlášek
Allowed memory size of … bytes exhausted. PHP došla paměť, kterou dostalo. Může za to jeden náročný plugin nebo nízký limit hostingu. Limit paměti zvýší hosting nebo ten, kdo se o web stará.
Call to undefined function … Kód volá funkci, která neexistuje. Častou příčinou je plugin, který závisí na jiném pluginu, jenž je deaktivovaný, nebo šablona, která po aktualizaci už k pluginu nesedí.
Maximum execution time of … seconds exceeded. Skript běžel déle, než server dovolí. Stává se to při importu, velké záloze nebo pomalém spojení s externí službou.
Uncaught Error: Class … not found. Chybí část kódu pluginu, například po nepovedené aktualizaci. Pomůže přeinstalovat stejnou verzi pluginu.
Cannot modify header information - headers already sent. Něco poslalo text do prohlížeče příliš brzy. Velmi často je to prázdný řádek nebo mezera na konci functions.php po ruční úpravě.
Hodnoty v hláškách se web od webu liší, proto jsou nahrazené výpustkou. Pokud log ukazuje fatální chybu a web nejede, přejděte na návod ke kritické chybě ve WordPressu. U bílé obrazovky nebo kódu 500 si přečtěte článek o chybě 500 ve WordPressu.
Co poslat hostingu nebo vývojáři
Dobře napsané hlášení ušetří několik kol zpráv. Uveďte:
- přesnou hlášku z logu, zkopírovanou, ne přepsanou zpaměti, spolu s cestou k souboru a číslem řádku,
- datum a čas, kdy se poprvé objevila, a zda se chyba opakuje,
- co se těsně předtím změnilo: aktualizace pluginu, šablony, WordPressu nebo verze PHP,
- na které stránce a při které akci se chyba objevuje, například při vkládání do košíku,
- verze WordPressu a PHP z Nástroje → Stav webu → Informace.
Před odesláním z výpisu odstraňte e-mailové adresy a další data zákazníků.
Jak chat logy přečte za vás
Plugin TellMyShop pro WordPress a WooCommerce čte chybové logy i v TellMyShop Free. Váš chat (Claude nebo ChatGPT) dostane chyby PHP, WordPressu a WooCommerce z posledních dní, seskupené: stejná hláška je jeden řádek s počtem a datem posledního výskytu. U každé uvede plugin nebo šablonu, ze které pochází, a vysvětlí hlášku běžnými slovy. E-maily, telefonní čísla a IP adresy v logech jsou zamaskované.
Vy: Od včerejška se košík občas nenačte. Podívej se do logů.
Váš chat: Za poslední dva dny je tu jedna fatální chyba, opakovaná asi desetkrát:
Allowed memory size exhausted, v souboru pluginu pro výpočet dopravy.
Objevuje se jen při otevření košíku. Plugin dostal včera novou verzi.
Můj návrh: nahlaste chybu autorovi, nebo se vraťte k předchozí verzi pluginu. Limit paměti je věc hostingu.
Výsledek v této konverzaci je příklad. Chat čte to, co se zapsalo. Pokud je zápis do debug.log vypnutý, v logu WordPressu nic nebude. Chat ho zapnout nemůže: wp-config.php je pro plugin vždy blokovaný, v každé verzi. To je úkol pro vás, hosting nebo toho, kdo se o web stará.
Pro diagnostiku stačí čtení logů, stavu webu a seznamu pluginů a je zdarma. Když je příčinou plugin, v TellMyShop Pro ho chat umí deaktivovat nebo aktualizovat po zapnutí přepínače Pluginy na 24 hodin, vždy s náhledem a po vašem souhlasu. Bezplatnou verzi si stáhnete ze stránky TellMyShop Free, Pro popisuje stránka TellMyShop pro WordPress a WooCommerce a rozdíly jsou na stránce ceník.
Otázky a odpovědi
Kde je ve WordPressu soubor debug.log?
Ve výchozím stavu ve složce wp-content, ale jen když jsou ve wp-config.php zapnuté WP_DEBUG a WP_DEBUG_LOG. Soubor vznikne při první chybě po zapnutí zápisu. Pokud tam není, zápis je vypnutý, nebo od jeho zapnutí žádná chyba nenastala.
Ukáže zapnutí WP_DEBUG chyby zákazníkům?
Může, pokud necháte zapnuté zobrazování chyb. Na živém webu zapisujete do souboru s vypnutým zobrazováním, tedy s WP_DEBUG_DISPLAY nastaveným na false. Pak chyby jdou jen do debug.log.
Je třeba varování Deprecated hned opravovat?
Obvykle ne. Říkají, že plugin nebo šablona používá funkci, která v budoucnu z PHP nebo WordPressu zmizí. Web funguje, ale před změnou verze PHP se vyplatí nahlásit je autorovi pluginu nebo hledat aktualizaci.
Může chybový log obsahovat data zákazníků?
Ano, někdy se tam dostanou e-mailové adresy, IP adresy nebo části požadavků. Proto celý soubor nezveřejňujte na fóru a zápis nenechávejte zapnutý bez potřeby. Plugin TellMyShop při čtení logů maskuje e-maily, telefonní čísla a IP adresy.
Kdo má přístup k logům serveru?
Váš hosting. Chybové logy PHP na serveru bývají v administraci hostingu, v sekci statistik nebo logů. Pokud je tam nevidíte, požádejte podporu o výpis z doby, kdy se chyba objevila.
WordPress je ochranná známka WordPress Foundation. WooCommerce je ochranná známka společnosti Automattic Inc. Claude je ochranná známka společnosti Anthropic PBC. ChatGPT a OpenAI jsou ochranné známky společnosti OpenAI. TellMyShop s těmito společnostmi není propojen.