L’attivazione della modalità debug richiede la modifica di un file della tua installazione di WordPress. È un’operazione semplice, ma deve essere eseguita con attenzione per evitare di compromettere il sito. Qui di seguito troverai istruzioni passo dopo passo su come farlo correttamente.
Una volta attivata, potrai registrare gli errori, nasconderli ai visitatori e controllare come WordPress gestisce le informazioni di debug. Ciò è particolarmente importante nei siti in produzione, dove vuoi che gli errori vengano registrati ma non mostrati pubblicamente.
Individuare il file wp-config.php
Il primo passo per abilitare la modalità debug è individuare il file wp-config.php. Questo file si trova nella cartella principale della tua installazione di WordPress, nello stesso percorso in cui si trovano wp-content, wp-includes e wp-admin. Puoi accedervi tramite un software FTP, il file manager del pannello di controllo del tuo hosting o in locale se lavori su un server di sviluppo.
È consigliabile creare una copia di backup di questo file prima di apportare modifiche. Basta un solo carattere mancante per rompere il sito, quindi avere una copia ti permette di ripristinarlo immediatamente. Una volta trovato il file, aprilo con un editor di testo e preparati a modificare la configurazione.
Attivare WP_DEBUG
All’interno del file wp-config.php, scorri finché non trovi una riga simile a questa: define( 'WP_DEBUG', false );. Questa riga controlla se la modalità debug è attiva o meno. Per impostazione predefinita, WordPress disattiva il debug per motivi di sicurezza e prestazioni. Per attivarlo, devi semplicemente cambiare il valore da false a true.
La riga corretta dovrebbe essere così: define( 'WP_DEBUG', true );. Dopo aver salvato il file, WordPress inizierà immediatamente a mostrare avvisi, notifiche ed errori PHP in tutto il sito. Questo ti permette di identificare plugin, temi o codice personalizzato problematico.
Usare WP_DEBUG_LOG per registrare gli errori
Sebbene la visualizzazione degli errori sullo schermo possa essere utile in fase di sviluppo, non è sempre pratica. Per un monitoraggio a lungo termine puoi attivare WP_DEBUG_LOG. Per farlo, aggiungi la seguente riga subito sotto la costante WP_DEBUG: define( 'WP_DEBUG_LOG', true );. In questo modo, tutti gli errori verranno registrati in un file debug.log all’interno della cartella wp-content.
Avere un file di log è particolarmente utile quando devi tracciare errori che si verificano in momenti specifici o che non riesci a riprodurre direttamente sullo schermo. Ti consente anche di condividere il file con sviluppatori o team di supporto senza dover dare accesso diretto al sito.
Nascondere gli errori ai visitatori
Se il tuo sito WordPress è online, probabilmente non vuoi che i visitatori vedano messaggi di errore grezzi. In tal caso puoi aggiungere un’altra impostazione per disattivare la visualizzazione nel frontend: define( 'WP_DEBUG_DISPLAY', false );. In questo modo, gli errori continueranno a essere registrati ma non verranno mostrati agli utenti.
Inoltre puoi aggiungere @ini_set( 'display_errors', 0 ); per rafforzare questo comportamento. Questa combinazione mantiene il sito professionale e sicuro, pur continuando a fornire le informazioni necessarie nel file di log per amministratori e sviluppatori.
Debug avanzato con SCRIPT_DEBUG
Per gli sviluppatori che lavorano con JavaScript e CSS, WordPress offre una costante aggiuntiva: define( 'SCRIPT_DEBUG', true );. Per impostazione predefinita, WordPress carica versioni minimizzate di script e fogli di stile. Attivando il debug degli script, WordPress caricherà le versioni complete e non minimizzate, più facili da analizzare e correggere.
Questa impostazione è particolarmente utile se stai sviluppando temi o plugin e hai bisogno di controllare il comportamento di script e stili. Non è comunemente necessaria per gli utenti generici, ma può fare una grande differenza per gli sviluppatori che risolvono problemi sul frontend.
In sintesi, abilitare la modalità debug in WordPress è un metodo semplice ma potente per diagnosticare e mantenere il tuo sito web. Modificando il file wp-config.php, puoi visualizzare gli errori, registrarli nei log e mantenere l’aspetto professionale del sito anche durante i problemi. Usata correttamente, la modalità debug è uno degli strumenti più importanti per mantenere WordPress sicuro, stabile e adatto agli sviluppatori.
