--- title: "Átláthatóbb WordPress hibakeresés Acornnal: Symfony, Ignition vagy Whoops" url: "https://helloblog.io/hu/atlathatobb-wordpress-hibakereses-acornnal/" date: "2023-02-14" modified: "2026-01-20" author: "Kovács Anna" language: "hu_HU" categories: ["WordPress ökoszisztéma"] tags: ["Bedrock", "Debugging", "Roots Acorn", "WordPress", "WP_DEBUG"] featured_image: "https://helloblog.io/app/uploads/sites/2/2026/01/featured-1-1024x572.png" excerpt: "A \u0060WP_DEBUG\u0060 bekapcsolása alap, de a natív hibakiírás sokszor inkább hátráltat. Mutatom, hogyan ad az Acorn olvashatóbb exception oldalt WordPress-ben, és mikor érdemes Ignitiont vagy Whoopsot használni." --- # Átláthatóbb WordPress hibakeresés Acornnal: Symfony, Ignition vagy Whoops WordPress fejlesztés közben a `WP_DEBUG` az egyik legolcsóbb és leghasznosabb biztosíték: gyorsan előhozza a notice-okat, warningokat és fatál hibákat. A gond csak az, hogy a WordPress alapértelmezett hibamegjelenítése (amikor `WP_DEBUG` és a képernyőre írás is engedélyezett) elég fapados: a hibaüzenetek egyszerűen ráégnek az oldal tetejére, kontextus nélkül, nehezen olvashatóan. Ha Roots-alapú stackben dolgozol (Bedrock + Acorn), akkor jó eséllyel már eleve modernebb fejlesztői élményre építesz. Az Acorn ugyanis képes jelentősen kulturáltabb error page-et adni WordPress alatt is, és ezzel a hibakeresés tempója konkrétan érezhetően javul. ## Miért „kevés” a natív WP_DEBUG kimenet? A `WP_DEBUG` lényege, hogy fejlesztéskor ne maradjanak rejtve a problémák. Ez különösen fontos, mert a WordPress ökoszisztémában rengeteg bővítmény és sablon szór notice-okat vagy hibákat, amik később (például PHP verzióváltásnál) komoly gondot okozhatnak. A natív megjelenítés viszont jellemzően: - széteső formázással jelenik meg az oldal tetején - nem ad szép stack trace-t (vagy ha ad is, nehezen áttekinthető) - nem segít gyorsan megtalálni, melyik fájl/sor/függvényhívás az igazi ok ![A WordPress alapértelmezett WP_DEBUG hibakiírása a képernyőn](https://helloblog.io/app/uploads/sites/2/2026/01/wp_debug-default-scaled.png) *A natív WP_DEBUG kimenet hasznos, de nehezen olvasható és gyorsan káosszá válik. — *Forrás: Roots.io** ## Mit csinál másképp az Acorn? Az Acorn egy olyan projekt, ami WordPress-ben hoz be Laravel-közeli komponenseket és fejlesztői kényelmet. Hibakezelésnél az a nagy nyereség, hogy amikor a `WP_DEBUG` és a képernyőre történő megjelenítés is aktív, akkor az Acorn egy jóval olvashatóbb exception oldalt ad a nyers WordPress-kiírás helyett. #### Mikor lép életbe? A forrás alapján az Acorn akkor javítja a hibakimenetet, ha `WP_DEBUG` és `WP_DEBUG_DISPLAY` is engedélyezve van. (Utóbbi a képernyőre írást szabályozza.) ### Alapértelmezett Acorn hibakimenet: Symfony exception handler Acornból alapból a Symfony exception handler érkezik. Ez már önmagában nagy ugrás: áttekinthetőbb a kivétel (exception) megjelenítése, könnyebb a stack trace-t böngészni, gyorsabban találsz vissza a hibás sorhoz. ![Acorn alapértelmezett WP_DEBUG kimenet Symfony exception handlerrel](https://helloblog.io/app/uploads/sites/2/2026/01/wp_debug-acorn-symfony-scaled.png) *Symfony exception handlerrel is sokkal vállalhatóbb a hibakeresés. — *Forrás: Roots.io** ### Ignition: Laravel-szintű hibakezelés WordPress-ben is Ha Laravelből jössz, az Ignition nagy eséllyel ismerős: a Laravel 9 óta ez az alapértelmezett hibapanel. Az Acorn v3 egyik fontos változása, hogy már támogatja a Laravel routingot (routing = útvonalkezelés), és ezzel együtt WordPress-es Acorn projektekben is használhatóvá vált az Ignition. Gyakorlatban ez a legkomfortosabb hibakeresési élmény: modern, jól tagolt error page, könnyen olvasható stack trace, és kifejezetten fejlesztőbarát tálalás. ![Acorn WP_DEBUG kimenet Ignitionnel](https://helloblog.io/app/uploads/sites/2/2026/01/wp_debug-acorn-ignition-scaled.png) *Ignitionnel a WordPress-es hibakeresés is Laravel-hangulatot kap. — *Forrás: Roots.io** #### Ignition telepítése Composerrel A telepítés a forrás alapján egy dev függőség felvétele. Arra figyelj, hogy ugyanabban a könyvtárban futtasd, ahol az Acorn is telepítve van (tipikusan a projekt gyökere, ahol a `composer.json` található). ``` composer require spatie/laravel-ignition --dev ``` ### Whoops: régebbi Acorn verziókhoz bevált opció Az Acorn v3 előtt gyakori javaslat volt a [whoops](https://github.com/filp/whoops) használata az Acorn mellé. Ha még Acorn v2-n vagy, a forrás alapján továbbra is van értelme: a Symfony-s oldalhoz képest jobb fejlesztői élményt adhat. ![Acorn WP_DEBUG kimenet Whoops-szal](https://helloblog.io/app/uploads/sites/2/2026/01/wp_debug-acorn-whoops-scaled.png) *Whoops: alternatíva, főleg ha régebbi Acornon ragadt egy projekt. — *Forrás: Roots.io** #### Verziók és döntés A forrás javaslata: ha Acorn v2-t használsz, érdemes Acorn v3-ra frissíteni. Whoops inkább azoknak lehet kapaszkodó, akik még nem tudnak váltani. ## Mi van, ha nem használsz Acornt? (Bővítményes alternatívák) Nem minden projekt Bedrock + Acorn alapú, és ez rendben van. Ha csak a WP_DEBUG kimenetet szeretnéd értelmezhetőbbé tenni, akkor a klasszikus WordPress-es út a fejlesztői bővítmények világa. - [Query Monitor](https://querymonitor.com/) – gyakorlatilag kötelező darab lokális WordPress környezetben - [Debug Bar](https://wordpress.org/plugins/debug-bar/) – egyszerűbb, de sok esetben már ez is nagy segítség ## Gyakorlati javaslat: hogyan állj neki egy modern debug setupnak? 1. Lokálban mindig legyen bekapcsolva a `WP_DEBUG` (és csak ott). 2. Ha Bedrocköt használsz, nézd meg az environment alapú beállításokat: fejlesztői környezetben jellemzően alapból aktív a debug. 3. Acorn esetén hagyatkozhatsz az alap Symfony handlerre, de ha komolyan fejlesztesz és sokat hibakeresel, az Ignition kényelmi ugrás. 4. Ha nem Acornos a projekt, telepíts Query Monitort, és használd napi szinten. ## Összefoglaló A `WP_DEBUG` bekapcsolása továbbra is a WordPress fejlesztés egyik alapja, de a natív hibakiírás könnyen átláthatatlanná válik. Acorn alatt rögtön kapsz egy kulturáltabb exception oldalt (Symfony), és Acorn v3-mal már Ignitiont is használhatsz, ami sokaknak a legjobb fejlesztői élmény. Ha pedig Acorn nélkül dolgozol, a Query Monitor és a Debug Bar jó, bevált alternatívák. ## Hivatkozások / Források - [Better WordPress Debugging with Acorn](https://roots.io/better-wordpress-debugging-with-acorn/) - [Bedrock](https://roots.io/bedrock/) - [Acorn documentation – Error handling (Ignition)](https://roots.io/acorn/docs/error-handling/#ignition) - [Acorn documentation – Upgrading Acorn](https://roots.io/acorn/docs/upgrading-acorn/) - [Query Monitor](https://querymonitor.com/) - [Debug Bar](https://wordpress.org/plugins/debug-bar/) - [filp/whoops](https://github.com/filp/whoops)