{"id":136,"date":"2023-02-14T00:00:00","date_gmt":"2023-02-13T23:00:00","guid":{"rendered":"https:\/\/helloblog.io\/it\/debug-wordpress-con-acorn-e-ignition\/"},"modified":"2026-01-20T06:32:46","modified_gmt":"2026-01-20T05:32:46","slug":"debug-wordpress-con-acorn-e-ignition","status":"publish","type":"post","link":"https:\/\/helloblog.io\/it\/debug-wordpress-con-acorn-e-ignition\/","title":{"rendered":"Debug pi\u00f9 leggibile in WordPress: usare WP_DEBUG con Acorn (e Ignition)"},"content":{"rendered":"\n

In locale, tenere WP_DEBUG<\/code> attivo non \u00e8 un vezzo: \u00e8 l\u2019unico modo realistico per intercettare notice<\/em>, warning<\/em> ed eccezioni mentre stai sviluppando temi o plugin. Il problema \u00e8 che l\u2019esperienza \u201cstandard\u201d di WordPress, quando WP_DEBUG<\/code> (e spesso anche WP_DEBUG_DISPLAY<\/code>) sono abilitati, \u00e8 piuttosto spartana: messaggi buttati a schermo, poco contesto, stack trace che non aiutano davvero.<\/p>\n\n\n\n

Se lavori con lo stack Roots (in particolare Bedrock + Acorn), puoi rendere il debugging molto pi\u00f9 leggibile senza cambiare le abitudini base: lasci WP_DEBUG<\/code> attivo, ma migliori drasticamente come<\/strong> vengono presentati gli errori.<\/p>\n\n\n\n

WP_DEBUG: cosa fa e perch\u00e9 va sempre attivato in sviluppo<\/h2>\n\n\n\n

WP_DEBUG<\/code> \u00e8 la modalit\u00e0 di debug di WordPress: si abilita impostando la costante WP_DEBUG<\/code> nel file di configurazione. In un ambiente di sviluppo dovrebbe essere sempre attiva per scovare subito problemi che altrimenti resterebbero nascosti (e finirebbero in produzione sotto forma di bug intermittenti).<\/p>\n\n\n\n

Se usi Bedrock (il boilerplate moderno per WordPress basato su Composer), la configurazione di sviluppo abilita gi\u00e0 WP_DEBUG<\/code> di default, quindi parti avvantaggiato: non devi ricordarti di accenderlo progetto per progetto.<\/p>\n\n\n\n

Il limite dell\u2019output di default di WordPress<\/h2>\n\n\n\n

Quando WordPress mostra direttamente a schermo errori e avvisi, ottieni s\u00ec un segnale immediato, ma spesso con scarsa ergonomia: output mischiato al markup della pagina, informazioni ripetitive e un formato che non guida verso la causa reale. In un ecosistema dove non \u00e8 raro imbattersi in plugin e temi che generano notice<\/em> a raffica, questo diventa presto rumore.<\/p>\n\n\n\n

\"Output
Con WP_DEBUG attivo, WordPress tende a stampare errori e notice direttamente a schermo, con poca leggibilit\u00e0. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

Come Acorn migliora WP_DEBUG (Symfony exception handler)<\/h2>\n\n\n\n

Acorn (il framework application-level dei Roots per portare un\u2019esperienza pi\u00f9 \u201cLaravel-like\u201d in WordPress) interviene sull\u2019esperienza di debug quando WP_DEBUG<\/code> e WP_DEBUG_DISPLAY<\/code><\/strong> sono abilitati. In pratica, invece del testo grezzo, Acorn usa di default l\u2019exception handler di Symfony, che rende le eccezioni pi\u00f9 leggibili e navigabili.<\/p>\n\n\n\n

\"Output
Con Acorn, l\u2019errore viene gestito con una pagina di eccezione pi\u00f9 chiara (handler Symfony). \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n
\n\n

Nota pratica<\/h4>\n\n\n

Acorn migliora l\u2019output quando WP_DEBUG<\/code> e WP_DEBUG_DISPLAY<\/code> sono attivi: se in locale non vedi la pagina di errore \u201cricca\u201d, verifica di non aver disabilitato la visualizzazione a schermo.<\/p>\n\n<\/div>\n\n\n\n

Ignition su WordPress con Acorn v3: l\u2019esperienza \u201calla Laravel\u201d<\/h2>\n\n\n\n

Se arrivi dal mondo Laravel, conosci gi\u00e0 Ignition: \u00e8 la pagina di errore predefinita di Laravel (dalla v9) e offre un contesto molto pi\u00f9 utile quando qualcosa va storto. Con l\u2019uscita di Acorn v3, Acorn include il supporto al routing in stile Laravel e questo apre la porta a Ignition anche su siti WordPress basati su Acorn.<\/p>\n\n\n\n

Il risultato \u00e8 una pagina di errore estremamente comoda durante lo sviluppo: stack trace chiari, contesto migliore e una UX di debugging coerente con quella che molti team gi\u00e0 usano su progetti Laravel.<\/p>\n\n\n\n

\"Output
Con Ignition, il debugging in WordPress (via Acorn) diventa molto pi\u00f9 simile a quello di Laravel. \u2014 Forr\u00e1s: Roots.io<\/em><\/figcaption><\/figure>\n\n\n\n

Installazione di Ignition (solo dev) via Composer<\/h3>\n\n\n\n

Per iniziare a usare Ignition in un progetto WordPress con Acorn, installalo come dipendenza di sviluppo con Composer dalla stessa directory dove \u00e8 installato Acorn:<\/p>\n\n\n\n

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