{"id":148,"date":"2023-02-14T00:00:00","date_gmt":"2023-02-13T23:00:00","guid":{"rendered":"https:\/\/helloblog.io\/nl\/wordpress-debuggen-wp-debug-acorn\/"},"modified":"2026-01-20T06:32:48","modified_gmt":"2026-01-20T05:32:48","slug":"wordpress-debuggen-wp-debug-acorn","status":"publish","type":"post","link":"https:\/\/helloblog.io\/nl\/wordpress-debuggen-wp-debug-acorn\/","title":{"rendered":"WordPress debuggen zonder hoofdpijn: WP_DEBUG slimmer maken met Acorn"},"content":{"rendered":"\n

Als je regelmatig aan WordPress-thema\u2019s of plugins sleutelt, ken je het: je zet WP_DEBUG<\/code> aan, krijgt een onleesbare notice-bingo bovenin je pagina, en je bent alsnog meer tijd kwijt aan zoeken dan aan fixen. WP_DEBUG<\/code> is essentieel, maar de presentatie<\/em> van fouten is in core behoorlijk basic.<\/p>\n\n\n\n

In deze post laat ik zien wat er precies mis is met de standaard WP_DEBUG<\/code>-output, en waarom Acorn (Roots) dat op een nette, moderne manier oplost. Werk je met Bedrock (WordPress-boilerplate met Composer)? Dan is dit extra interessant, omdat debuggen daar sowieso al wat strakker is ingericht.<\/p>\n\n\n\n

WP_DEBUG in het kort (en waarom je het lokaal altijd aan wilt hebben)<\/h2>\n\n\n\n

WordPress heeft een ingebouwde debugmodus die je activeert via de WP_DEBUG<\/code> constant in je configuratie. In lokale development-omgevingen wil je WP_DEBUG<\/code> eigenlijk altijd aan hebben: je vangt sneller notices, warnings en echte errors, en je voorkomt dat je rommelige edge-cases per ongeluk doorschuift naar staging of productie.<\/p>\n\n\n\n

Gebruik je Bedrock (de moderne WordPress setup met Composer)? Dan staat WP_DEBUG<\/code> volgens de Bedrock-configuratie standaard aan in development-omgevingen. Dat is een fijne default: je hoeft minder vaak te onthouden dat je debug nog uit stond.<\/p>\n\n\n\n

Waarom de standaard WP_DEBUG-output vaak niet genoeg is<\/h2>\n\n\n\n

De standaard output van WP_DEBUG<\/code> is functioneel, maar niet prettig: foutmeldingen en notices worden direct in de HTML gerenderd. Je krijgt weinig context, het is visueel rommelig, en bij exceptions mist vaak de developer-ervaring die je uit moderne frameworks gewend bent.<\/p>\n\n\n\n

Het resultaat: je ziet dat<\/em> er iets misgaat, maar je workflow blijft: kopi\u00ebren, terugzoeken, stacktrace ontwarren, en hopen dat je snel bij de juiste regel uitkomt.<\/p>\n\n\n\n

\"Standaard
De standaard WP_DEBUG-output: direct op het scherm, weinig context. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

Acorn: WP_DEBUG-output die w\u00e9l prettig leest<\/h2>\n\n\n\n

Acorn is het PHP framework van Roots dat Laravel-achtige features naar WordPress brengt. Denk aan helpers, service containers en een modernere developer experience. Een van de meest tastbare verbeteringen: foutafhandeling (error handling) die je debugoutput drastisch leesbaarder maakt.<\/p>\n\n\n\n

Belangrijk detail: Acorn verbetert de output wanneer WP_DEBUG<\/code> \u00e9n WP_DEBUG_DISPLAY<\/code> aan staan. Daarna neemt Acorn de presentatie van exceptions over, zodat je in plaats van \u201cplatte\u201d meldingen een nette errorpagina krijgt met stacktrace en context.<\/p>\n\n\n\n

Acorn standaard: Symfony exception handler<\/h3>\n\n\n\n

Zonder extra packages gebruikt Acorn standaard de Symfony exception handler. Die geeft je al een veel beter leesbare exception-pagina dan WordPress core. Vooral bij fatals en uncaught exceptions scheelt dit enorm in zoektijd.<\/p>\n\n\n\n

\"Acorn
Acorn gebruikt standaard de Symfony exception handler voor nettere exceptions. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

Acorn + Ignition: de Laravel-ervaring, maar dan in WordPress<\/h3>\n\n\n\n

Als je uit de Laravel-hoek komt, is Ignition waarschijnlijk bekend: de errorpagina die sinds Laravel v9 de standaard is. Met Acorn v3 is Ignition ook beschikbaar in WordPress-projecten die Acorn gebruiken. Dat komt doordat Acorn v3 ondersteuning toevoegt voor routing zoals in Laravel, en daarmee ook Ignition kan integreren.<\/p>\n\n\n\n

In de praktijk betekent dit: een errorpagina die gemaakt is om snel te debuggen, met een heldere stacktrace en een prettige UI. Roots raadt Ignition aan voor de beste error handling-ervaring in WordPress met Acorn.<\/p>\n\n\n\n

\"Acorn
Ignition geeft een moderne, Laravel-achtige errorpagina binnen WordPress via Acorn. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

Ignition gebruik je als dev dependency. Vanuit dezelfde directory waar Acorn ge\u00efnstalleerd is, installeer je het met Composer:<\/p>\n\n\n\n

<\/circle><\/circle><\/circle><\/g><\/svg><\/span>