Ricerca nel sito web

Come abilitare la modalità debug di WordPress per correggere gli errori


Come puoi abilitare la modalità debug in WordPress o ottenere maggiori informazioni sugli errori WordPress visualizzati su un browser web? Se sei un utente o uno sviluppatore WordPress e stai ponendo queste domande, sei arrivato sulla risorsa giusta. Questa guida ti mostrerà come abilitare le funzionalità di debug di WordPress.

WordPress fornisce diversi potenti strumenti di debug sia per sviluppatori che per utenti non programmatori o generici, che puoi abilitare utilizzando le opzioni di configurazione disponibili. Queste opzioni, una volta abilitate, ti aiutano a trovare e risolvere rapidamente gli errori mostrando informazioni dettagliate sull'errore.

Dimostreremo utilizzando il seguente errore che abbiamo riscontrato durante la configurazione di un sito fittizio a scopo di test.

Quando guardi questo errore, non ci sono molte informazioni che lo accompagnano. Potrebbero esserci molte cause: il server del database potrebbe essere inattivo o le impostazioni di connessione al database (ovvero nome del database, utente del database e password dell'utente) definite nel file di configurazione wp-config.php potrebbero essere in errore.

Quindi, come possiamo ottenere maggiori informazioni sull'errore sopra riportato? L'opzione WP_DEBUG è una variabile globale permanente PHP che attiva la modalità “debug” in WordPress, causando così la visualizzazione di tutti gli errori, avvisi e avvisi PHP sul browser.

Questa funzione “debug” è stata aggiunta nella versione 2.3.1 di WordPress ed è configurata in wp-config.php, uno dei file più importanti nella tua installazione di WordPress.

Per impostazione predefinita, la funzione “debug” è impostata su false in qualsiasi installazione di WordPress. Per abilitare WP_DEBUG, impostalo su true.

Innanzitutto, spostati nella directory di installazione del tuo sito web, ad esempio /var/www/html/mysite.com, quindi apri il file wp-config.php utilizzando il tuo editor di testo preferito.

cd /var/www/html/mysite.com
sudo vim wp-config.php

Cerca questa linea.

define( 'WP_DEBUG',  false );

e cambiarlo in

define( 'WP_DEBUG', true );

Salva il file e chiudilo.

Ora è stata attivata la modalità debug. Se ricarichiamo la pagina che mostrava l'errore, possiamo vedere le informazioni dettagliate sull'errore come mostrato nello screenshot seguente.

Esistono opzioni di debug aggiuntive che estendono WP_DEBUG che sono particolarmente utili per gli sviluppatori WordPress che creano plugin o temi o qualsiasi altro componente. Sono WP_DEBUG_LOG e WP_DEBUG_DISPLAY.

L'opzione WP_DEBUG_LOG se impostata su true fa sì che tutti gli errori vengano salvati in un file di registro debug.log all'interno di /wp-content / per impostazione predefinita. Ciò è utile per analisi o elaborazioni successive.

define( 'WP_DEBUG_LOG', true );

Puoi però specificare un file di log personalizzato, ad esempio /var/log/nginx/mysite.com_wp-errors.log:

define( 'WP_DEBUG_LOG', '/var/log/nginx/mysite.com_wp-errors.log' );

E WP_DEBUG_DISPLAY controlla se i messaggi di debug vengono mostrati o meno all'interno dell'HTML delle pagine. Per impostazione predefinita, è impostato su true. Per disabilitarlo, impostalo su false.

define( 'WP_DEBUG_DISPLAY', false );

Abilita la modalità debug in WordPress utilizzando il plugin

Se utilizzi un hosting condiviso, probabilmente non hai accesso al backend del server per modificare i tuoi file WordPress, in questo caso il file wp-config.php.

Oppure, se preferisci semplicemente modificare le impostazioni dal dashboard di amministrazione, puoi installare e utilizzare un plug-in chiamato "Debug Bar" che ti consente di abilitare/disabilitare facilmente WP_DEBUG dal dashboard di amministrazione con un solo clic sul pannello di amministrazione. Barra degli strumenti.

La caratteristica killer di questo plugin è che è sicuro e intelligente, esce automaticamente dalla modalità WP_DEBUG in caso di errori.

Riferimento: debug in WordPress.