WordPress debug modus maakt verborgen fouten, waarschuwingen en notificaties zichtbaar die normaal stilzwijgend worden genegeerd. Je activeert het door drie regels toe te voegen aan wp-config.php, waarna fouten worden weggeschreven naar een logbestand. Zo spoor je plugin-conflicten, thema-problemen en PHP-fouten snel op, zonder dat bezoekers er iets van merken.
Wat is WordPress debug modus?
Debug modus is een ingebouwde functie van WordPress die PHP-fouten, waarschuwingen en notices opvangt en zichtbaar of logbaar maakt. Standaard staat deze modus uit, zodat bezoekers nooit foutmeldingen op je site zien. Als beheerder of ontwikkelaar wil je die meldingen juist wél zien, bijvoorbeeld bij het testen van een nieuw thema, het installeren van plugins of het onderzoeken van een witte pagina (de bekende “white screen of death”).
Met debug modus kun je:
- PHP-fouten en waarschuwingen opsporen
- Conflicten tussen plugins en thema’s blootleggen
- Verouderde functies (deprecated) signaleren
- Database-queries en scriptfouten analyseren
Debug modus inschakelen via wp-config.php
Het bestand wp-config.php bevat de basisinstellingen van je WordPress-installatie en staat in de root van je site. Je kunt het bewerken via FTP of via het bestandsbeheer in Plesk.
Verbind met je hostingaccount
Log in via FTP of open het bestandsbeheer in Plesk en navigeer naar de root-map van je WordPress-site (meestal public_html of de map van je domeinnaam).
Open wp-config.php
Zoek het bestand in de root-directory en open het in een teksteditor. Maak voor de zekerheid eerst een kopie van het bestand.
Voeg de debug-constanten toe
Zoek de regel / That's all, stop editing! / en voeg daarboven toe:
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Sla op en controleer
Sla het bestand op en bezoek je site. Fouten verschijnen niet meer op het scherm, maar worden nu weggeschreven naar wp-content/debug.log.
WP_DEBUG_DISPLAY alleen op true tijdens testen op een aparte ontwikkelomgeving, nooit op je live-site.Het debug logbestand gebruiken
Zodra WP_DEBUG_LOG aanstaat, legt WordPress elke fout vast in wp-content/debug.log. Dit bestand bevat tijdstempels, foutmeldingen en de bestandsnaam waar de fout optreedt, wat precies vertelt waar je moet zoeken.
Je opent het logbestand via het bestandsbeheer in Plesk of via FTP met een teksteditor. Bij grote sites kan dit bestand snel groeien, dus controleer het regelmatig en verwijder of archiveer het zodra je klaar bent met debuggen, zodat het geen onnodige schijfruimte inneemt.
Herken je in het logbestand een melding over een specifieke plugin of thema-bestand, dan weet je direct waar het probleem zit. Zo kun je gericht een plugin updaten, uitschakelen of de betreffende code aanpassen.
Veilig debuggen op een live-site
Debug modus inschakelen op een productiesite brengt risico’s met zich mee als fouten zichtbaar worden voor bezoekers: dit kan gevoelige informatie over je serverpad of configuratie prijsgeven. Houd daarom altijd deze combinatie aan op een live-site:
WP_DEBUGop true zodat fouten worden opgevangenWP_DEBUG_LOGop true zodat ze worden gelogdWP_DEBUG_DISPLAYop false zodat ze nooit op het scherm verschijnen
Werk je liever op een aparte testomgeving, dan is dat de veiligste route: pas daar wijzigingen toe, test ze grondig en zet pas daarna debug modus weer uit voordat je live gaat. Vergeet ook niet om na het debuggen de regels weer te verwijderen of op false te zetten, zodat je site niet onnodig logt.
Loop je tegen hardnekkige fouten aan die niet in het logbestand verklaard worden, bekijk dan ook de instellingen van je webhosting-omgeving of raadpleeg de kennisbank voor meer achtergrondinformatie.
Veelgestelde vragen
Kan ik debug modus op mijn live-site inschakelen?
Ja, mits je WP_DEBUG_DISPLAY op false zet. Fouten worden dan alleen gelogd, niet getoond aan bezoekers.
Waar vind ik het debug.log bestand?
In de map wp-content/debug.log, te openen via FTP of het bestandsbeheer in Plesk.
Hoe schakel ik debug modus weer uit?
Zet WP_DEBUG op false of verwijder de drie debug-regels volledig uit wp-config.php.
Heeft debug modus invloed op de snelheid van mijn site?
Logging kost iets extra verwerkingstijd, maar dit is op test-omgevingen verwaarloosbaar. Zet het op je live-site daarom uit zodra je klaar bent.
Ik zie geen debug.log bestand, wat nu?
Controleer of de map wp-content schrijfrechten heeft en of de drie regels correct en zonder typefouten zijn toegevoegd aan wp-config.php.
Conclusie
WordPress debug modus activeer je door drie regels toe te voegen aan wp-config.php. Zo leg je fouten vast in een logbestand zonder ze zichtbaar te maken voor bezoekers. Controleer het logbestand regelmatig, schakel debug modus na gebruik weer uit en werk bij voorkeur op een testomgeving voor grotere wijzigingen.