Besseres WordPress-Debugging mit Acorn: WP_DEBUG endlich sinnvoll lesen

In WordPress ist WP_DEBUG der klassische Schalter, um Notices, Warnings und Exceptions in der Entwicklung sichtbar zu machen. Aktiviert man ihn konsequent lokal, fängt man viele Probleme früh ab – gerade weil im WordPress-Ökosystem (Themes, Plugins, MU-Plugins) erstaunlich oft „kleine“ Notices entstehen, die später im falschen Moment zu echten Bugs werden.

Das Problem: Die Standardausgabe von WordPress ist funktional, aber unbequem. Sie wirft Meldungen einfach ins HTML, ohne Kontext, ohne Stacktrace-Darstellung, ohne gute Lesbarkeit. Genau hier setzt Acorn an: Es erweitert die Ausgabe von WP_DEBUG so, dass du Fehler ähnlich angenehm analysieren kannst wie in modernen PHP-Frameworks.

WP_DEBUG in WordPress: Was passiert standardmäßig?

Wenn WP_DEBUG aktiv ist, schreibt WordPress Fehlermeldungen und PHP-Notices je nach Konfiguration direkt ins Markup (und/oder in Logs). Für schnelle Sichtbarkeit ist das okay – aber beim echten Debugging fehlt oft das, was du brauchst: klare Exception-Seiten, konsistente Stacktraces, saubere Darstellung von Request- und Kontextinfos.

Bedrock-Setup: WP_DEBUG ist in Development oft schon gesetzt

Wenn du mit Bedrock arbeitest (modernes WordPress-Boilerplate mit Composer), ist WP_DEBUG in Development-Umgebungen typischerweise bereits aktiviert. Das nimmt dir eine Fehlerquelle ab: Du startest nicht aus Versehen „blind“ in eine lokale Session, sondern siehst Notices und Errors sofort.

Acorn als Upgrade für WP_DEBUG-Ausgaben

Acorn ist das Roots-Paket, das Laravel-Komponenten in WordPress-Projekte bringt (u. a. Service Container, Commands, Helpers). Fürs Debugging besonders interessant: Wenn WP_DEBUG und WP_DEBUG_DISPLAY aktiv sind, ersetzt Acorn die eher rohe WordPress-Ausgabe durch deutlich besser lesbare Error-Handling-Seiten.

Acorns Default: Symfony Exception Handler

Ohne weitere Zusatzpakete nutzt Acorn standardmäßig den Symfony Exception Handler. Das liefert dir eine strukturierte Exception-Ansicht, bei der du schneller erkennst, wo der Fehler ausgelöst wurde und welche Pfade beteiligt sind.

Ignition in WordPress: Laravel-Feeling dank Acorn v3

Wenn du aus der Laravel-Welt kommst, kennst du vermutlich Ignition: die Error-Page, die seit Laravel v9 der Standard ist. Mit Acorn v3 ist Ignition auch in WordPress-Projekten nutzbar, weil Acorn seit v3 Laravel-Routing unterstützt – und damit auch das Ignition-Integration-Setup möglich wird.

Für Ignition installierst du das Paket in der Regel als Dev-Dependency über Composer (im gleichen Verzeichnis, in dem Acorn installiert ist):

composer require spatie/laravel-ignition --dev

composer require spatie/laravel-ignition --dev

Whoops: die frühere Empfehlung (v. a. für Acorn v2)

Vor Acorn v3 war whoops (filp/whoops) eine verbreitete Empfehlung, um bessere Error-Pages zu bekommen. Wenn du noch auf Acorn v2 bist, kann whoops die DX spürbar verbessern. Langfristig ist ein Upgrade auf Acorn v3 naheliegend, wenn du die modernere Integration (inkl. Ignition) nutzen willst.

Ohne Acorn: sinnvolle Debug-Alternativen als Plugins

Nicht jedes Projekt läuft mit Acorn – und manchmal willst du in einem bestehenden Setup nur gezielt observability nachrüsten. Für eine bessere Debug-Erfahrung rund um WP_DEBUG und Performance-Analysen sind diese Plugins besonders gängig:

• Query Monitor – für viele lokale Setups quasi Pflicht: DB-Queries, Hooks, HTTP-Calls, PHP-Errors, REST-Requests und mehr.
• Debug Bar – klassische Debug-Leiste mit technischen Infos, gut als leichtgewichtiger Einstieg.

Kurzfazit: Was bringt dir Acorn beim Debugging konkret?

1. Du behältst WP_DEBUG als WordPress-Mechanik, bekommst aber eine deutlich bessere Darstellung von Exceptions.
2. Mit Acorn v3 kannst du Ignition nutzen und erhältst eine Debug-Experience, die viele aus Laravel kennen.
3. Auch ohne Ignition liefert Acorn (Symfony Handler) eine spürbar aufgeräumtere Fehleranalyse als die Standardausgabe.
4. Für Projekte ohne Acorn bleiben Query Monitor und Debug Bar solide Werkzeuge, um Probleme schneller einzugrenzen.