Het inschakelen van de debugmodus vereist het bewerken van één bestand in je WordPress-installatie. Het is eenvoudig, maar moet zorgvuldig worden gedaan om te voorkomen dat de site kapot gaat. Hieronder vind je stapsgewijze instructies om het correct te doen.
Zodra de debugmodus is ingeschakeld, kun je fouten loggen, ze verbergen voor bezoekers en bepalen hoe WordPress met debug-informatie omgaat. Dit is vooral belangrijk op live websites, waar je fouten wilt registreren maar niet openbaar tonen.
Het wp-config.php-bestand vinden
De eerste stap om de debugmodus in te schakelen, is het vinden van het bestand wp-config.php. Dit bestand bevindt zich in de hoofdmap van je WordPress-installatie, op dezelfde plek waar je wp-content, wp-includes en wp-admin vindt. Je kunt het openen via een FTP-programma, de bestandsbeheerder van je hostingprovider of lokaal als je op een ontwikkelserver werkt.
Het is aan te raden een back-up van dit bestand te maken voordat je wijzigingen aanbrengt. Eén ontbrekend teken kan je site onbruikbaar maken, en met een back-up kun je deze direct herstellen. Zodra je het bestand hebt gevonden, open je het in een teksteditor en kun je de configuratie aanpassen.
WP_DEBUG inschakelen
In het bestand wp-config.php scroll je naar de regel die er zo uitziet: define( 'WP_DEBUG', false );. Deze regel bepaalt of de debugmodus actief is of niet. Standaard is debugging in WordPress uitgeschakeld om veiligheids- en prestatieredenen. Om de debugmodus te activeren, hoef je de waarde alleen te wijzigen van false naar true.
De juiste regel ziet er zo uit: define( 'WP_DEBUG', true );. Nadat je het bestand hebt opgeslagen, begint WordPress onmiddellijk met het weergeven van PHP-waarschuwingen, meldingen en foutmeldingen op je hele website. Zo kun je problematische plugins, thema’s of aangepaste code identificeren.
WP_DEBUG_LOG gebruiken voor foutregistratie
Hoewel het tonen van fouten op het scherm nuttig kan zijn tijdens ontwikkeling, is het niet altijd praktisch. Voor langdurige monitoring kun je WP_DEBUG_LOG inschakelen. Voeg hiervoor de volgende regel toe direct onder de WP_DEBUG-constante: define( 'WP_DEBUG_LOG', true );. Alle fouten worden dan opgeslagen in een bestand debug.log in de map wp-content.
Een logbestand is vooral handig als je fouten moet volgen die op specifieke momenten optreden of die je niet direct op het scherm kunt reproduceren. Het stelt je ook in staat het bestand te delen met ontwikkelaars of supportteams zonder hen directe toegang tot je site te geven.
Fouten verbergen voor bezoekers
Als je WordPress-site live staat, wil je waarschijnlijk niet dat bezoekers ruwe foutmeldingen zien. In dat geval kun je een extra instelling toevoegen om de weergave aan de voorkant uit te schakelen: define( 'WP_DEBUG_DISPLAY', false );. Hiermee worden fouten nog steeds gelogd, maar niet getoond aan gebruikers.
Daarnaast kun je @ini_set( 'display_errors', 0 ); toevoegen om dit gedrag extra te versterken. Deze combinatie zorgt ervoor dat je site professioneel en veilig blijft, terwijl de nodige informatie beschikbaar blijft in het debuglog voor beheerders en ontwikkelaars.
Geavanceerd debuggen met SCRIPT_DEBUG
Voor ontwikkelaars die met JavaScript en CSS werken, biedt WordPress een extra constante: define( 'SCRIPT_DEBUG', true );. Standaard laadt WordPress geminificeerde versies van scripts en stijlen. Door script-debugging in te schakelen, laadt WordPress de volledige, niet-geminificeerde versies, die gemakkelijker te inspecteren en te debuggen zijn.
Deze instelling is vooral waardevol als je thema’s of plugins ontwikkelt en het gedrag van scripts en stijlen wilt volgen. Voor gewone gebruikers is het meestal niet nodig, maar voor ontwikkelaars kan het een groot verschil maken bij het oplossen van frontend-problemen.
Samengevat is het inschakelen van de debugmodus in WordPress een eenvoudige maar krachtige manier om je website te diagnosticeren en te onderhouden. Door het bestand wp-config.php aan te passen, kun je fouten weergeven, ze in logs opslaan en je site professioneel laten ogen, zelfs tijdens problemen. Correct gebruikt is de debugmodus een van de belangrijkste hulpmiddelen om WordPress veilig, stabiel en ontwikkelaarsvriendelijk te houden.
