Kennisbank

Debugmodus in WordPress: WP_DEBUG en debug.log gebruiken

Een foutmelding in WordPress zegt vaak weinig over de oorzaak. Je leest hoe de debugconstanten samenwerken, waar debug.log staat, hoe je die afschermt en hoe je een fatal error leest. Ook zie je hoe je notices en deprecated-meldingen onderscheidt van echte fouten en waarom je de debugmodus daarna weer uitzet.

Gepubliceerd op: 18 november 2026|Door carlokop|0 Reacties|4 min leestijd

Een witte pagina, de melding dat er een kritieke fout is opgetreden of een plugin die ineens niet meer doet wat hij moet doen: WordPress vertelt je zelden uit zichzelf waar het misgaat. Daarvoor heeft WordPress een debugmodus, die PHP-fouten zichtbaar maakt en desgewenst naar een logbestand schrijft. Hieronder lees je hoe die modus werkt, hoe je hem veilig gebruikt op een live site en hoe je de meldingen leest.

De debugmodus van WordPress: WP_DEBUG, WP_DEBUG_LOG en WP_DEBUG_DISPLAY

De debugmodus bestaat uit drie constanten in wp-config.php. Die zet je boven de regel met "That's all, stop editing!".

Constante

Standaard

Effect

WP_DEBUG

false

Zet de rapportage van alle PHP-fouten aan, inclusief notices en deprecated-meldingen

WP_DEBUG_LOG

false

Schrijft naar wp-content/debug.log, of naar een pad dat je opgeeft. Werkt alleen met WP_DEBUG aan

WP_DEBUG_DISPLAY

true

Toont fouten in de HTML. Zet dit op een live site altijd op false

Voor een live site wil je de combinatie: WP_DEBUG aan, WP_DEBUG_LOG aan en WP_DEBUG_DISPLAY uit. WordPress schrijft dan alle PHP-fouten, waarschuwingen en notices naar het logbestand, zonder ze aan bezoekers te tonen. Het is gebruikelijk om daarnaast de PHP-instelling display_errors uit te zetten, voor het geval je server die standaard aan heeft.

De regels zelf hoef je niet te typen. Vraag een AI-assistent of je ontwikkelaar om deze drie constanten in wp-config.php te zetten, of gebruik het bestandsbeheer van je hosting. Let op twee dingen: de waarden zijn booleans zonder aanhalingstekens ('false' tussen quotes is een niet-lege string en wordt als true gelezen), en een tikfout in wp-config.php legt je hele site plat. Maak dus eerst een kopie van het bestand. WP_DEBUG staat standaard uit en is niet bedoeld voor permanent gebruik op een live site.

Waar debug.log staat en hoe je hem afschermt

Met WP_DEBUG_LOG aan komt de log in wp-content/debug.log. Die map staat in de webroot. Blokkeert je server het bestand niet, dan kan iedereen het via /wp-content/debug.log opvragen, inclusief serverpaden, querydelen en soms gebruikersgegevens.

Er zijn twee oplossingen:

  • Een pad buiten de webroot. In plaats van true kun je WP_DEBUG_LOG een volledig bestandspad geven, bijvoorbeeld een map logs naast je public_html. Dan is het bestand niet via een URL bereikbaar. Dit heeft de voorkeur.
  • Het bestand blokkeren op de server. Kan dat niet, laat dan op Apache in .htaccess of op Nginx in de serverconfiguratie toegang tot debug.log weigeren. Een AI-assistent schrijft die regel voor je; vertel erbij welke webserver je hosting gebruikt.

Test het daarna: open /wp-content/debug.log in een privévenster. Je wilt een 403 of 404 zien, niet de inhoud van de log.

Een fatal error lezen

Een fatal error stopt de uitvoering. Elke regel in de log begint met een tijdstempel in UTC, gevolgd door het type fout (PHP Fatal error, Warning, Notice of Deprecated), de melding zelf, het volledige pad naar het bestand en het regelnummer. Bij PHP 8 volgt bij een fatal error vaak een stack trace: een genummerde lijst van de functies en hooks waarlangs de foute code werd aangeroepen.

Het pad is meestal het belangrijkste deel. Staat er wp-content/plugins/ gevolgd door een mapnaam, dan weet je welke plugin de fout veroorzaakt; staat er wp-content/themes/, dan is het je thema. De stack trace laat zien via welke hook de code liep, wat helpt als twee plugins elkaar in de weg zitten.

Kun je niet meer inloggen, deactiveer de plugin dan door de map via SFTP of het bestandsbeheer van je hosting te hernoemen. WordPress ziet de plugin dan niet meer en laadt hem niet. Heb je een AI-assistent met toegang tot je server of WP-CLI, dan kan die dat ook voor je doen.

Uitgelegde regel uit WordPress debug.log met fouttype, plugin, bestand, regelnummer en stack trace

Uitgelegde regel uit WordPress debug.log met fouttype, plugin, bestand, regelnummer en stack trace (fictieve waarden).

Notices en deprecated-meldingen onderscheiden van fouten

  • Fatal error: de pagina breekt af. Dit los je eerst op.
  • Warning: iets ging mis, maar de code loopt door. Vaak een ontbrekend bestand of een verkeerd type argument.
  • Notice: een kleine fout, zoals een ongedefinieerde variabele of array-index.
  • Deprecated: code gebruikt een functie die in een volgende PHP- of WordPress-versie verdwijnt. Nu onschuldig, maar een signaal voor de volgende PHP-upgrade.

Een log vol notices en deprecated-meldingen van een plugin maakt de echte fout moeilijk te vinden. Zoek daarom eerst op "Fatal error" en kijk naar de laatste regels van het bestand: daar staat wat er bij je laatste poging gebeurde. Je kunt ook de hele log aan een AI-assistent geven met de vraag welke melding de pagina laat afbreken en welke plugin erbij hoort. Haal er dan eerst gevoelige gegevens zoals e-mailadressen uit.

Debugmodus na afloop uitzetten

Zet WP_DEBUG terug op false en verwijder of leeg debug.log. De log groeit anders onbeperkt door, en de debugmodus kost performance. Voor diepere analyse bestaan nog SCRIPT_DEBUG (onverkleinde core-scripts) en SAVEQUERIES (alle databasequeries vastleggen); die zet je alleen tijdelijk aan. Terugkerende fouten na updates zijn een signaal om je onderhoudsproces te bekijken.

Klaar voor actie?

Wil je dit toepassen op jouw website?

Ik help je de keuzes uit dit artikel om te zetten in een werkende setup, meetbaar en zonder technische ruis.

Verder lezen

Terug naar kennisbank

Alle artikelen in WordPress