--- title: "Besseres WordPress-Debugging mit Acorn: WP_DEBUG endlich sinnvoll lesen" url: "https://helloblog.io/de/besseres-wordpress-debugging-mit-acorn/" date: "2023-02-14" modified: "2026-01-20" author: "Markus Weber" language: "de_DE" categories: ["WordPress-Ökosystem"] tags: ["Acorn", "Bedrock", "Composer", "Debugging", "WordPress"] featured_image: "https://helloblog.io/app/uploads/sites/3/2026/01/featured-3-1024x572.png" excerpt: "WP_DEBUG ist Pflicht in der lokalen Entwicklung – aber die Standardausgabe ist kaum hilfreich. Mit Acorn bekommst du Exception-Pages, die du aus dem Laravel-Ökosystem kennst, inklusive Ignition-Support." --- # 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. ![Standardausgabe von WP_DEBUG in WordPress mit direkt im HTML gerenderten Fehlermeldungen](https://helloblog.io/app/uploads/sites/3/2026/01/wp_debug-default-scaled.png) *So sieht WP_DEBUG ohne zusätzliche Tools häufig aus: Meldungen landen direkt auf der Seite. — *Forrás: Roots.io** ## 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. ![Acorn nutzt standardmäßig eine Symfony-Exception-Page für WP_DEBUG](https://helloblog.io/app/uploads/sites/3/2026/01/wp_debug-acorn-symfony-scaled.png) *Acorns Standard-Error-Page (Symfony) ist deutlich lesbarer als die WordPress-Ausgabe. — *Forrás: Roots.io** ### 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. ![WP_DEBUG-Ausgabe in WordPress mit Acorn und Ignition im Laravel-Stil](https://helloblog.io/app/uploads/sites/3/2026/01/wp_debug-acorn-ignition-scaled.png) *Mit Ignition bekommst du die vertraute Laravel-Debug-Experience direkt in WordPress. — *Forrás: Roots.io** 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 ``` #### Hinweis zu WP_DEBUG_DISPLAY Acorn verbessert die Bildschirm-Ausgabe, wenn `WP_DEBUG` und `WP_DEBUG_DISPLAY` aktiv sind. In Staging/Production willst du Fehler in der Regel nicht im Frontend ausgeben – dort gehören sie in Logs und Monitoring. ### 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. ![WP_DEBUG-Ausgabe in WordPress mit Acorn und whoops](https://helloblog.io/app/uploads/sites/3/2026/01/wp_debug-acorn-whoops-scaled.png) *Whoops liefert ebenfalls eine deutlich bessere Fehlerseite als der WordPress-Default. — *Forrás: Roots.io** ## 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](https://querymonitor.com/) – für viele lokale Setups quasi Pflicht: DB-Queries, Hooks, HTTP-Calls, PHP-Errors, REST-Requests und mehr. - [Debug Bar](https://wordpress.org/plugins/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. ## Referenzen / Quellen - [Better WordPress Debugging with Acorn](https://roots.io/better-wordpress-debugging-with-acorn/) - [Bedrock](https://roots.io/bedrock/) - [whoops](https://github.com/filp/whoops) - [Query Monitor](https://querymonitor.com/) - [Debug Bar](https://wordpress.org/plugins/debug-bar/)