WordPress debug mode inschakelen

Wanneer uw WordPress-site zich vreemd gedraagt zonder duidelijke melding, is debug mode het belangrijkste hulpmiddel om de oorzaak te vinden. In dit artikel schakelt u WP_DEBUG veilig in, schrijft u foutmeldingen naar een logbestand en zet u debugging daarna weer uit om geen informatie te lekken.

Probleem

Er treedt een fout of onverwacht gedrag op in WordPress, maar zonder zichtbare melding is de oorzaak niet te achterhalen.

Oorzaak

WordPress onderdrukt foutmeldingen standaard op productiesites, zodat bezoekers geen technische details te zien krijgen. Hierdoor blijft de oorzaak van een probleem verborgen.

Zonder logregistratie verdwijnen fouten die kort optreden, waardoor ze moeilijk te reproduceren en op te lossen zijn.

Plugins en thema’s kunnen waarschuwingen of fouten genereren die alleen met debugging zichtbaar worden.

Oplossing

Schakel WP_DEBUG in via wp-config.php, laat fouten naar een logbestand schrijven in plaats van naar het scherm, analyseer de meldingen en zet debugging weer uit zodra het probleem is opgelost.

Stappenplan

1. Maak een back-up van het bestand wp-config.php.
2. Open wp-config.php via FTP of bestandsbeheer.
3. Zet de constante WP_DEBUG op true.
4. Voeg WP_DEBUG_LOG op true toe zodat fouten naar een logbestand gaan.
5. Zet WP_DEBUG_DISPLAY op false zodat fouten niet op het scherm verschijnen.
6. Herlaad de site of voer de actie uit die het probleem veroorzaakt.
7. Open het bestand wp-content/debug.log en analyseer de meldingen.
8. Zet alle debug-constanten weer uit zodra het probleem is opgelost.

Configuratievoorbeeld: debug-instellingen in wp-config.php

Plaats de volgende regels boven de regel met ’That’s all, stop editing!’ in wp-config.php voor veilige, gelogde debugging:

Voorbeeld:

// Debugging inschakelen
define( ’WP_DEBUG’, true );

// Fouten naar wp-content/debug.log schrijven
define( ’WP_DEBUG_LOG’, true );

// Fouten NIET op het scherm tonen (veilig voor live)
define( ’WP_DEBUG_DISPLAY’, false );
@ini_set( ’display_errors’, 0 );

// Optioneel: scriptdebugging voor onverkleinde bestanden
define( ’SCRIPT_DEBUG’, true );

Wat de debug-constanten doen

WP_DEBUG is de hoofdschakelaar die WordPress vertelt fouten en waarschuwingen te genereren. Op zichzelf zou dit de meldingen op het scherm tonen, wat op een live site ongewenst is. Daarom combineert u WP_DEBUG met WP_DEBUG_LOG en WP_DEBUG_DISPLAY om de meldingen veilig naar een logbestand te sturen in plaats van naar bezoekers.

Het logbestand debug.log verschijnt in de map wp-content en bevat tijdstempels, foutniveaus en verwijzingen naar het bestand en de regel waar de fout optreedt. Deze informatie is goud waard bij het opsporen van conflicten: vaak ziet u direct welke plugin of welk themabestand de fout veroorzaakt.

Laat debugging nooit permanent aanstaan op een productiesite. Het logbestand kan gevoelige paden en informatie bevatten en bovendien snel groot worden. Schakel de constanten uit zodra het probleem is opgelost en verwijder of beveilig het logbestand indien nodig.

Veelgemaakte fouten

• WP_DEBUG_DISPLAY op true laten staan op een live site, waardoor bezoekers fouten zien.
• Debugging permanent aan laten staan en het logbestand laten vollopen.
• wp-config.php bewerken zonder back-up.
• Het debug.log-bestand niet beveiligen terwijl het gevoelige paden bevat.
• De debug-regels onder ’stop editing’ plaatsen, waardoor ze niet werken.
• De meldingen niet koppelen aan het genoemde bestand en de regel.

Controle na afloop

1. Controleer of het bestand wp-content/debug.log wordt aangemaakt en gevuld.
2. Controleer of er geen fouten op het scherm verschijnen voor bezoekers.
3. Controleer of de gelogde fout verwijst naar een herkenbare plugin of bestand.
4. Controleer of debugging na het oplossen weer is uitgeschakeld.

Praktische tips

• Combineer altijd WP_DEBUG_LOG en WP_DEBUG_DISPLAY op false voor live sites.
• Verwijder of beveilig het debug.log-bestand na gebruik.
• Gebruik SCRIPT_DEBUG om problemen met scripts en stijlen te onderzoeken.

Veelgestelde vragen

Is debug mode veilig op een live site?

Alleen als u fouten naar een logbestand schrijft en niet op het scherm toont; schakel het daarna weer uit.

Waar staat het logbestand?

In wp-content/debug.log, mits u WP_DEBUG_LOG op true hebt gezet.

Vertraagt debugging mijn site?

Het kan een lichte invloed hebben en het logbestand groeit; laat het daarom niet permanent aanstaan.

Samenvatting

Met WordPress debug mode maakt u verborgen fouten zichtbaar. U zet WP_DEBUG op true, schrijft fouten via WP_DEBUG_LOG naar wp-content/debug.log en houdt WP_DEBUG_DISPLAY op false zodat bezoekers niets zien. Analyseer de meldingen, los het probleem op en schakel debugging daarna weer uit voor de veiligheid.

Gerelateerde artikelen

• WordPress-update veilig uitvoeren
• WordPress-update terugdraaien (rollback)
• WordPress-plugin installeren

Komt u er niet uit? Plan een gratis strategiegesprek via https://www.bdmnl.nl/plan.