WordPress foutenlog: waar je de fout vindt en wat de meldingen betekenen
Het WordPress foutenlog bestaat uit bestanden waarin de server, WordPress en plugins de details van fouten vastleggen: de melding, het bestand en de regel. Kijk op drie plekken: debug.log in de map wp-content (als het loggen in wp-config.php aan staat), je hostingpaneel, en WooCommerce → Status → Logboeken. Zonder logs is een fout oplossen giswerk.
Auteur: Het TellMyShop-team. Een gids voor eigenaren van WordPress-websites en WooCommerce-winkels: de oorzaak, de oplossing met de hand en hetzelfde werk in een gesprek met de chat.
Laatst bijgewerkt: · 6 min lezen
Drie plekken om te kijken
Elk van deze plekken legt iets anders vast. Controleer ze in deze volgorde, de makkelijkste eerst.
| Plek | Wat daar terechtkomt | Hoe je er komt | Wie er meestal toegang toe heeft |
|---|---|---|---|
| WooCommerce → Status → Logboeken, bestand fatal-errors | fatale PHP-fouten met bestand en regel | het dashboard, als dat werkt | jij |
| debug.log in wp-content | fouten, waarschuwingen en meldingen van WordPress en plugins | bestandsbeheerder van de hosting of FTP, als het loggen aan staat | jij of je websitebeheerder |
| PHP-foutenlog op de server | PHP-fouten, ook als WordPress helemaal niet laadt | hostingpaneel | de hostingpartij, soms jij |
Een WooCommerce-webshop heeft een voordeel: het log fatal-errors werkt zonder in bestanden te graven. WooCommerce raadt zelf aan daar te beginnen, zoals beschreven in de documentatie van WooCommerce over het vinden van PHP-foutenlogs.
Zo zet je debug.log stap voor stap aan
Loggen naar debug.log zet je aan in wp-config.php. Dat bestand bevat het wachtwoord van je database, dus werk op een kopie en wees voorzichtig. Voel je je niet zeker, vraag het dan je hostingpartij of je websitebeheerder.
- Maak een kopie van wp-config.php in de bestandsbeheerder van je hosting.
- Open wp-config.php om te bewerken en zoek de regel met WP_DEBUG.
- Zet WP_DEBUG op true, voeg WP_DEBUG_LOG op true toe en WP_DEBUG_DISPLAY op false.
- Sla het bestand op en herhaal wat de fout veroorzaakt, bijvoorbeeld de pagina openen of een product in de winkelwagen leggen.
- Open wp-content/debug.log en lees de laatste regels.
- Ben je klaar, zet WP_DEBUG dan terug op false.
Alle constanten en wat ze doen, staan in het WordPress-handboek over debuggen. Een korte uitleg van het bestand zelf staat in het woordenlijstitem van GreenGeeks over WP Debug Log.
Het bestand debug.log staat in een map die soms via een browser bereikbaar is. Laat het loggen niet zonder reden blijvend aan staan, of vraag je hostingpartij de toegang tot dat bestand te blokkeren.
Zo lees je een regel in het log
Elke regel heeft een vergelijkbare vorm: datum en tijd, foutniveau, melding, en aan het eind het pad naar het bestand en het regelnummer. Het pad is het belangrijkst. Bevat het wp-content/plugins/pluginnaam, dan is die plugin de schuldige. Staat er wp-content/themes/themanaam, dan is het thema het.
Niveaus, van het ernstigst:
- Fatal error: de code is gestopt, en de pagina of een deel ervan werkt niet.
- Warning: er ging iets mis, maar de pagina gaat door.
- Notice en Deprecated: notities voor ontwikkelaars, meestal zonder effect op bezoekers.
Woordenlijst: vijf veelvoorkomende meldingen
Allowed memory size of … bytes exhausted. PHP had niet genoeg geheugen. Eén zware plugin of een laag limiet bij de hosting kan de oorzaak zijn. Het geheugenlimiet verhoogt je hostingpartij of je websitebeheerder.
Call to undefined function … De code roept een functie op die niet bestaat. Een veelvoorkomende oorzaak is een plugin die afhangt van een andere plugin die gedeactiveerd is, of een thema dat na een update niet meer bij een plugin past.
Maximum execution time of … seconds exceeded. Een script liep langer dan de server toestaat. Dat gebeurt tijdens een import, een grote back-up of een trage verbinding met een externe dienst.
Uncaught Error: Class … not found. Een deel van de code van een plugin ontbreekt, bijvoorbeeld na een mislukte update. Dezelfde versie van de plugin opnieuw installeren helpt.
Cannot modify header information - headers already sent. Iets stuurde te vroeg tekst naar de browser. Heel vaak is het een lege regel of een spatie aan het eind van functions.php na een handmatige aanpassing.
De waarden in meldingen verschillen per site, dus ze zijn vervangen door een beletselteken. Toont het log een fatale fout en ligt de site plat, ga dan naar de handleiding over de kritieke fout in WordPress. Bij een wit scherm of code 500 lees je het stuk over de 500 error in WordPress.
Wat je je hostingpartij of ontwikkelaar stuurt
Een goed geschreven melding scheelt een paar rondes berichten. Vermeld:
- de exacte melding uit het log, gekopieerd en niet uit je hoofd overgetypt, samen met het pad naar het bestand en het regelnummer,
- de datum en tijd waarop ze voor het eerst verscheen, en of de fout steeds terugkomt,
- wat er vlak daarvoor is veranderd: een update van een plugin, het thema, WordPress of de PHP-versie,
- op welke pagina en bij welke handeling de fout verschijnt, bijvoorbeeld bij het toevoegen aan de winkelwagen,
- de versies van WordPress en PHP uit Gereedschap → Sitestatus → Info.
Haal voor het versturen e-mailadressen en andere klantgegevens uit het fragment.
Zo leest de chat de logs voor je
De TellMyShop-plugin voor WordPress en WooCommerce leest foutenlogs ook in TellMyShop Free. Je chat (Claude of ChatGPT) krijgt de fouten van PHP, WordPress en WooCommerce van de laatste dagen, gegroepeerd: dezelfde melding is één regel met een aantal en de datum waarop ze het laatst verscheen. Bij elke melding noemt hij de plugin of het thema waar ze vandaan komt en legt hij de melding in gewone woorden uit. E-mailadressen, telefoonnummers en IP-adressen in de logs zijn gemaskeerd.
Jij: Sinds gisteren laadt de winkelwagen soms niet. Kijk eens in de logs.
Je chat: In de laatste twee dagen staat er één fatale fout, een stuk of twaalf keer herhaald:
Allowed memory size exhausted, in een bestand van de plugin voor het berekenen van verzendkosten.
Hij verschijnt alleen als de winkelwagen opent. De plugin kreeg gisteren een nieuwe versie.
Mijn voorstel: meld de fout aan de maker of ga terug naar de vorige versie van de plugin. Het geheugenlimiet is een zaak voor je hostingpartij.
Het resultaat in dit gesprek is een voorbeeld. De chat leest wat er is vastgelegd. Staat het loggen naar debug.log uit, dan staat er niets in het log van WordPress. De chat kan het niet aanzetten: wp-config.php is voor de plugin altijd geblokkeerd, in elke versie. Dat doe jij, je hostingpartij of je websitebeheerder.
Logs, de gezondheid van de website en de lijst met plugins lezen is genoeg voor een diagnose, en het is gratis. Is een plugin de oorzaak, dan kan de chat hem in TellMyShop Pro deactiveren of bijwerken zodra je de schakelaar Plugins 24 uur aanzet, altijd met een voorbeeld en na jouw akkoord. De gratis versie download je op de pagina TellMyShop Free, Pro staat beschreven op de pagina TellMyShop voor WordPress en WooCommerce, en de verschillen staan op de pagina prijzen.
Vragen en antwoorden
Waar staat het bestand debug.log in WordPress?
Standaard in de map wp-content, maar alleen als WP_DEBUG en WP_DEBUG_LOG aan staan in wp-config.php. Het bestand wordt aangemaakt bij de eerste fout nadat het loggen is aangezet. Staat het er niet, dan staat het loggen uit of zijn er sinds het aanzetten geen fouten geweest.
Toont WP_DEBUG aanzetten fouten aan klanten?
Dat kan, als je het tonen van fouten aan laat staan. Op een live site log je naar een bestand met het tonen uit, dus WP_DEBUG_DISPLAY op false. Dan gaan fouten alleen naar debug.log.
Moeten waarschuwingen Deprecated meteen worden opgelost?
Meestal niet. Ze zeggen dat een plugin of thema een functie gebruikt die in de toekomst uit PHP of WordPress verdwijnt. De site werkt, maar voor een wissel van PHP-versie loont het om ze aan de maker van de plugin te melden of naar een update te zoeken.
Kan een foutenlog klantgegevens bevatten?
Ja, e-mailadressen, IP-adressen of stukken van verzoeken komen er soms in terecht. Zet het hele bestand dus niet op een forum en laat het loggen niet zonder reden aan staan. De TellMyShop-plugin maskeert e-mailadressen, telefoonnummers en IP-adressen als hij logs leest.
Wie heeft toegang tot de serverlogs?
Je hostingpartij. De PHP-foutenlogs van de server staan meestal in het hostingpaneel, bij statistieken of logs. Zie je ze daar niet, vraag de support dan om het fragment van het moment waarop de fout verscheen.
WordPress is een handelsmerk van de WordPress Foundation. WooCommerce is een handelsmerk van Automattic Inc. Claude is een handelsmerk van Anthropic PBC. ChatGPT en OpenAI zijn handelsmerken van OpenAI. TellMyShop is niet gelieerd aan deze bedrijven.