Guida:come attivare il debug in WordPress per scoprire gli errori
- Word press
- 17 settembre 2025
Indice dei contenuti
Il debug di WordPress è una funzione che permette di evidenziare errori nascosti e conflitti interni. Attivandolo è possibile comprendere meglio l’origine di schermate bianche, avvisi o malfunzionamenti legati a plugin, temi e configurazioni del server. Si tratta di uno strumento indispensabile per chi gestisce un sito e desidera mantenerlo stabile e sicuro.
Dove si configurano le opzioni di debug
Le impostazioni del debug si trovano nel file wp-config.php, presente nella cartella principale dell’installazione di WordPress. Questo file contiene parametri essenziali per il funzionamento del sito e include la riga che controlla la modalità debug:
define( 'WP_DEBUG', false );
Per modificare il file è necessario usare un client FTP o accedere al filemanager se presente sul tuo hosting
Il metodo migliore è usare Filezilla, un client che permette di accedere ai file del server, modificarli e ricaricarli. Si tratta di un piccolo programma gratuito da installare sia su Win che LNX che Mac. Qui ho pubblicato una guida su come usare Filezilla, leggila e dopo torna qui e prosegui.
Attivazione del debug
Per attivare il debug è sufficiente modificare la riga in questo modo:
define( 'WP_DEBUG', true );
Da questo momento WordPress inizierà a mostrare messaggi di errore che indicano file coinvolti, righe di codice e tipologie di problemi. Queste informazioni consentono di capire se il malfunzionamento è legato a funzioni deprecate, errori di sintassi o limiti di memoria.
Informazioni restituite
Con la modalità attiva vengono fornite indicazioni utili come:
- percorso del file in cui si verifica l’errore
- numero di riga interessato
- natura del problema riscontrato
Opzioni avanzate
WordPress consente di estendere la diagnostica con ulteriori costanti:
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Questa configurazione registra gli errori in un file chiamato debug.log situato nella cartella /wp-content, senza mostrare dettagli tecnici ai visitatori.
Disattivazione
Una volta completata l’analisi, è consigliabile riportare la configurazione allo stato iniziale per motivi di sicurezza:
define( 'WP_DEBUG', false );
Conclusione
La modalità debug in WordPress rappresenta un alleato prezioso per scoprire rapidamente errori e conflitti. Utilizzata correttamente, aiuta a migliorare la stabilità del sito e a ridurre i tempi di risoluzione dei problemi. Per un supporto professionale nella configurazione e nell’interpretazione dei messaggi di debug è possibile contattarmi per un aiuto.
