Wanneer je werkt met WordPress kan het gebeuren dat er onverwachte foutmeldingen of problemen ontstaan. Denk bijvoorbeeld aan een plugin die niet goed werkt, een update die iets breekt of een thema dat ineens conflicten veroorzaakt.
In dit artikel leggen we stap voor stap uit hoe je WordPress debugging inschakelen kunt gebruiken om zulke fouten te vinden en op te lossen. Dit is een handige manier om de bron van een probleem te achterhalen en er snel een oplossing voor te vinden. Het maakt niet uit of je al ervaring hebt of net begint, deze uitleg is voor iedereen begrijpelijk.
Wat is de debug-modus in WordPress?
WordPress heeft een ingebouwde functie waarmee je fouten kunt opsporen. Dit heet de debug-modus. De belangrijkste instelling hiervoor is WP_DEBUG. Dit is een code die je toevoegt in het bestand wp-config.php.
Wanneer je WordPress debugging inschakelen gebruikt, laat het systeem foutmeldingen en waarschuwingen zien die normaal gesproken verborgen blijven. Dat helpt je te begrijpen waar het probleem precies vandaan komt. Soms gaat het om echte fouten die opgelost moeten worden, maar soms zijn het alleen adviezen of aanbevelingen.
Hoe werkt WP_DEBUG?
WP_DEBUG is een Boolean waarde, dat wil zeggen dat deze alleen op true of false kan staan. Als je de waarde op true zet, dan worden foutmeldingen zichtbaar gemaakt. Zet je de waarde op false, dan blijven de meldingen verborgen. Het is belangrijk om te weten dat niet elke melding een ernstig probleem betekent. Soms gaat het alleen om suggesties van WordPress om je site beter te maken.
Hoe activeer je WordPress debugging?
Om WordPress debugging in te schakelen ga je eerst naar het hostingpaneel van je website en open je de File Manager. Daar ga je naar de map public_html. Dit is de plek waar je WordPress-bestanden staan. Zoek hier naar het bestand wp-config.php. Klik er met de rechtermuisknop op en kies voor EDIT. Nu kun je het bestand aanpassen.
Gebruik de zoekfunctie (CTRL + F) om te kijken of WP_DEBUG al in het bestand staat. Maak voordat je iets wijzigt altijd eerst een kopie van dit bestand. Mocht er iets misgaan, dan kun je gemakkelijk terug naar de oude versie.
Als de code voor WP_DEBUG er nog niet staat, voeg dan de volgende regel toe vlak vóór de tekst /* That’s all, stop editing! Happy blogging. */ en sla het bestand op:
define( 'WP_DEBUG', true );Vanaf nu staat de debug-modus aan en kun je fouten zien die anders verborgen blijven.
Fouten bekijken en logbestanden
Wanneer de debug-modus actief is, kan er een bestand worden aangemaakt waarin alle fouten worden opgeslagen. Dit bestand heet meestal debug.log en staat in de map wp-content. In dit logbestand worden fouten bijgehouden met de datum en tijd waarop ze zijn ontstaan. Zo kun je precies nagaan welk bestand of welke plugin de fout veroorzaakt.
Zorg er wel voor dat je het logbestand af en toe leegt, omdat het anders veel ruimte in beslag kan nemen op je hosting. Vooral als er veel fouten ontstaan, kan het logbestand snel groter worden.
Soms ontdek je in het logbestand dat berichten niet op tijd live gaan. Meer daarover lees je in Ingeplande blogberichten niet gepubliceerd?.
WordPress debugging uitschakelen
Als je klaar bent met het oplossen van problemen, is het slim om de debug-modus weer uit te zetten. Laat je dit per ongeluk aan staan, dan kunnen bezoekers foutmeldingen zien op je website en dat maakt geen goede indruk. Bovendien kan het een beveiligingsrisico zijn. Om debugging uit te schakelen verander je de waarde in het wp-config.php bestand naar:
define( 'WP_DEBUG', false );Zet dit altijd terug zodra je klaar bent met testen en fouten oplossen.
Een bekend voorbeeld van zo’n zichtbare fout is de 500 Internal Server Error. Bekijk hoe je dit oplost in 500 Internal Server Error of HTTP Error 500 oplossen.
Extra opties voor debugging in WordPress
Naast WP_DEBUG zijn er nog een aantal aanvullende functies die je kunt gebruiken. Deze plaats je net als WP_DEBUG in het bestand wp-config.php, vlak boven de regel /* That’s all, stop editing! Happy blogging. */. Ze werken dus als extra instellingen binnen dezelfde debug-modus.
- WP_DEBUG_LOG: hiermee kun je fouten opslaan in een logbestand in de map wp-content.
- WP_DEBUG_DISPLAY: hiermee bepaal je of foutmeldingen zichtbaar zijn voor bezoekers. Standaard staat dit aan, maar je kunt dit uitzetten met de regel define(‘WP_DEBUG_DISPLAY’, false);
- SCRIPT_DEBUG: hiermee kun je de originele versies van JavaScript en CSS-bestanden laden, handig als je bezig bent met ontwikkelen.
- SAVEQUERIES: hiermee sla je databasequery’s op, wat handig kan zijn voor het analyseren van de prestaties.
Een combinatie van deze instellingen kan je veel inzicht geven in de werking van je website. Bijvoorbeeld, je kunt foutmeldingen opslaan in een logbestand zonder dat bezoekers ze te zien krijgen.
Voorbeeld, dit is code voor in het bestand wp-config.php. Plak dit direct boven de regel /* That’s all, stop editing! Happy blogging. */ en sla op:
// Turn debugging on
define('WP_DEBUG', true);
// Log alles naar debug.log
define('WP_DEBUG_LOG', true);
// Verberg foutmeldingen voor bezoekers
define('WP_DEBUG_DISPLAY', false);Gebruik van plugins voor debugging
Niet iedereen voelt zich prettig bij het handmatig aanpassen van bestanden. Gelukkig zijn er ook plugins die debugging makkelijker maken. Twee bekende voorbeelden zijn:
WP Debugging: hiermee kun je alle instellingen voor debugging beheren zonder in bestanden te hoeven werken. Deze gratis plugin heeft meer dan 10.000 actieve installaties.
Query Monitor: een krachtige plugin die je helpt om scripts en databasequery’s te analyseren. Dit is een van de meest gebruikte tools met meer dan 200.000 actieve installaties.
Beide plugins zijn gratis en geven je inzicht in hoe je website werkt en waar fouten vandaan komen.
Kom je er niet uit met plugins en lukt het installeren niet? Lees dan ook ons artikel over Wat te doen als je geen WordPress plugin installeren kunt.
Conclusie
WordPress debugging inschakelen is een handige manier om fouten op je website op te sporen en op te lossen. Of je nu een ontwikkelaar bent of een beginner, met deze tool kun je zien waar problemen vandaan komen en hoe je ze kunt verhelpen. Gebruik debugging alleen wanneer je bezig bent met het testen of aanpassen van je site en zet het daarna altijd weer uit om je website veilig en professioneel te houden.
Krijg je bijvoorbeeld een 403 Foutmelding in WordPress, dan kan debugging je op weg helpen om de oorzaak te vinden. Lees meer in 403 Foutmelding in WordPress: oorzaken én oplossingen.
Veelgestelde vragen
1. Zijn er alternatieven voor WP_DEBUG als ik niet in bestanden wil werken?
Ja, je kunt gebruikmaken van plugins zoals WP Debugging of Query Monitor. Deze plugins geven je toegang tot dezelfde informatie zonder dat je handmatig code hoeft toe te voegen of bestanden hoeft te bewerken.
2. Heeft het inschakelen van debugging invloed op de veiligheid van mijn site?
Ja, omdat foutmeldingen en informatie worden opgeslagen kan dit een risico vormen. Zorg dat alleen jij toegang hebt tot deze bestanden.
3. Waar kan ik het debug.log bestand vinden?
Het bestand debug.log wordt automatisch aangemaakt in de map wp-content van je WordPress-installatie zodra WP_DEBUG_LOG actief is. Hierin staan alle fouten met datum en tijd vermeld.
4. Hoe kan ik debugging activeren of deactiveren?
Voeg de code define(‘WP_DEBUG’, true); toe om debugging te activeren en verander true in false om het uit te schakelen.
5. Is het verstandig om debugging op een live website ingeschakeld te laten?
Nee, het is beter om debugging alleen te gebruiken tijdens het testen of ontwikkelen. Laat je het aan op een live site, dan kunnen bezoekers foutmeldingen zien en kan gevoelige informatie zichtbaar worden.
6. Wat is WordPress Debug precies?
WordPress Debug is een ingebouwde functie die je helpt fouten en waarschuwingen in WordPress te vinden en op te lossen.
7. Kan ik debugging ook gebruiken om prestatieproblemen te analyseren?
Ja, met functies zoals SAVEQUERIES kun je databasequery’s opslaan en onderzoeken. Dit helpt je te ontdekken welke query’s traag zijn en welke optimalisaties mogelijk zijn.