Come abilitare la modalità di debug di WordPress: 2 metodi

Pubblicato: 2021-10-21

Stai cercando modi per risolvere i conflitti sul tuo sito? Trovare la causa dei problemi può farti risparmiare molto tempo, quindi se è qualcosa che ti interessa questo post è per te. In questa guida, ti mostreremo 2 modi per abilitare la modalità di debug di WordPress e trovare conflitti sul tuo sito web.

Indipendentemente da quanto stai attento, se hai un sito web dovrai sempre affrontare vari problemi. La risoluzione dei problemi di questi errori non è sempre facile e potrebbero essere necessarie ore per trovare la radice dei conflitti. Ecco perché sapere come risolvere questi problemi e risolverli è la chiave per evitare mal di testa. In questo articolo imparerai come abilitare la modalità di debug in WordPress e risolvere i tuoi problemi in pochissimo tempo.

Prima di approfondire, capiamo meglio qual è la modalità di debug.

Qual è la modalità di debug?

La modalità Debug è una tecnica utilizzata dagli sviluppatori per identificare potenziali minacce e avvisi causati da PHP o altri linguaggi di programmazione. Come probabilmente saprai, WordPress è costruito con PHP, JavaScript, HTML e CSS, quindi potresti riscontrare alcuni errori causati da errori nel codice. Ad esempio, il tuo sito potrebbe essere compromesso quando:

  • Aggiorna la versione PHP
  • Aggiungi codice personalizzato
  • Installa un nuovo tema/plugin
  • Aggiorna il tuo tema/plugin
  • Aggiorna WordPress

Di solito, i tuoi plugin causano conflitti a causa di un aggiornamento o di un'incompatibilità. I problemi variano molto e vanno da un conflitto innocuo alla creazione di problemi sulla pagina di pagamento o sullo schermo bianco della morte se sei sfortunato. Per impostazione predefinita, WordPress non viene fornito con una funzione integrata per monitorare questi conflitti, quindi può essere difficile sapere cosa sta succedendo. La buona notizia è che puoi fare alcune cose per poter vedere gli errori e correggerli prima che sia troppo tardi. Ciò ti consente di risolvere i problemi in modo più accurato e risolvere i problemi molto più velocemente.

Quando abiliti la modalità di debug, WordPress visualizzerà tutti gli errori nell'area di amministrazione proprio sotto la barra di navigazione in alto. In questo modo, puoi rapidamente tenere d'occhio gli avvisi e correggere tutto ciò che è necessario. Anche se non tutti gli errori richiedono un'attenzione urgente, correggerli non appena compaiono ti aiuterà a assicurarti che le cose non peggiorino e offri un'esperienza utente eccezionale.

Ora vediamo diversi modi per attivare la modalità di debug .

Come abilitare la modalità di debug di WordPress

Puoi abilitare la modalità di debug di WordPress in due modi:

  1. Manualmente
  2. Utilizzo di un plug-in

In questa sezione, ti mostreremo entrambi i metodi in modo da poter scegliere quello migliore in base alle tue esigenze.

1) Attiva manualmente la modalità di debug

Se hai capacità di programmazione e ti senti a tuo agio nella modifica dei file di base, questo metodo è per te. Per abilitare la modalità di debug, dovrai aggiungere un frammento di codice al tuo file wp-config.php . Puoi utilizzare un client FTP come FileZilla o un plug-in di gestione file dedicato. Per questa dimostrazione, utilizzeremo il plug-in File Manager.

NOTA : Le modifiche che faremo sono abbastanza semplici ma è sempre consigliabile creare un backup del tuo sito prima di iniziare.

1.1) Installa e attiva File Manager

La prima cosa che devi fare è installare e attivare il plug-in File Manager sulla tua installazione di WordPress. Vai su Plugin > Aggiungi nuovo, cerca il plugin e installalo.

reindirizzare una pagina wordpress - installare il file manager wp

1.2) Configurazione plug-in

Dopo l'attivazione, apri le impostazioni del plug-in in WP File Manager . Lì vedrai tutte le directory e i file ospitati sul tuo server.

gestore di file

Prima di modificare il file wp-config.php , ti consigliamo di scaricarne una copia sul tuo computer locale. In questo modo, se qualcosa va storto, puoi facilmente rimuovere la versione modificata e caricare il file principale. In questo modo, puoi aggiungere un'ulteriore precauzione.

scarica il file di configurazione wp

Una volta scaricato il file, in File Manager fare clic con il tasto destro del mouse sul file wp-config.php e utilizzare l'opzione Editor di codice per modificarlo.

abilita la modalità di debug di wordpress - editor di codice del file manager

1.3) Il frammento

Una volta aperto, vedrai l'editor. Da lì, puoi aggiungere o rimuovere il codice del file.

abilita la modalità di debug di wordpress - modifica la configurazione di wp

Se scorri fino in fondo, vedrai una riga che dice /* Questo è tutto, smetti di modificare! Buona pubblicazione. */. Copia il codice seguente e incollalo subito prima di quella riga.

 define( 'WP_DEBUG', vero);

Il codice dice semplicemente a WordPress di abilitare la modalità di debug.

salva il file di configurazione wp

Se il tuo file wp-config.php ha già questo snippet, ma la costante è impostata su false, non è necessario aggiungere nuovamente il codice. Tutto quello che devi fare è cambiare la parola false con true .

Non è tutto. Il problema con questo snippet è che visualizzerà tutti i conflitti del tuo sito web (se presenti) sul front e sul back-end. Ciò significa che se il tuo sito è attivo, i visitatori saranno in grado di vedere gli avvisi e potrebbero confonderli. Non c'è un modo per nasconderli? Si C'è! Inoltre, può essere utile tenere un registro di tutti i problemi.

1.4) Snippet per nascondere gli avvisi dal front-end

Per nascondere gli avvisi e mantenere il registro, utilizza lo snippet di seguito e incollalo sotto il codice di debug che hai appena aggiunto.

 // Salva debug.log in /wp-content/debug.log
define( 'WP_DEBUG_LOG', vero);

// Nascondi errori e avvisi
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

crea debug.log

Una volta terminato, ricordati di salvare le impostazioni e il gioco è fatto! Ora hai abilitato manualmente la modalità di debug in WordPress . D'ora in poi, sarai in grado di tenere d'occhio gli avvisi ma i visitatori del tuo sito Web non li vedranno sul front-end.

Se non ti senti a tuo agio con questo metodo, c'è un'altra alternativa per te.

2) Abilita la modalità di debug con un plugin

Se non vuoi modificare i file core, puoi attivare la modalità di debug con un plugin. In questa sezione, ti mostreremo come farlo passo dopo passo.

WP Debugging è un plug-in dedicato per abilitare la modalità di debug su qualsiasi installazione di WordPress. In questa sezione imparerai come farlo passo dopo passo.

2.1) Installazione e attivazione di WP Debugging

Prima di tutto, devi installare e attivare il plugin WP Debugging sul tuo sito web. Questo plug-in è nel repository, quindi, nella dashboard dell'amministratore, vai su Plugin> Aggiungi nuovo , cerca il plug-in e installalo.

abilita la modalità di debug di wordpress - installa il plug-in WP Debugging

2.2) Configurazione plug-in

Dopo aver installato e attivato il plugin, vedrai la configurazione nella sezione Strumenti .

abilita la modalità di debug di wordpress - impostazioni di debug di wp

Il plugin aggiungerà automaticamente questo codice al tuo file wp-config.php :

 define( 'WP_DEBUG', vero);
define( 'WP_DEBUG_LOG', vero);
define( 'SCRIPT_DEBUG', vero);
define( 'SAVEQUERIES', true );

Questo codice ha attivato la modalità di debug. Seleziona semplicemente l'opzione "Imposta WP-DEBUG su true" e salva le modifiche.

Questo mostrerà anche gli errori sul front-end, quindi ti consigliamo di selezionare anche l'opzione " Imposta WP_DEBUG_DISPLAY su false, l'impostazione predefinita è true" per nascondere gli avvisi.

Successivamente, visita alcune pagine del sito Web in cui hai problemi o conflitti per assicurarti che i messaggi non siano presenti. Infine, puoi anche controllare il file debug.log per i messaggi di errore.

Ed è così che puoi abilitare la modalità di debug in WordPress con un plug-in. Tieni presente che se disinstalli WP Debugging, il codice aggiunto verrà rimosso.

L'attivazione della modalità di debug è il primo passo. Ora devi sapere come controllare i messaggi di errore in modo da poterli correggere il più velocemente possibile. Vediamo come farlo.

Come controllare i messaggi di errore

Dopo aver abilitato la modalità di debug, WordPress memorizzerà un registro di ogni problema nel tuo server. Puoi trovare il log nel tuo file manager utilizzando un client FTP o con un plug-in dedicato. In questa sezione imparerai come controllare correttamente i messaggi di errore.

Per questa dimostrazione utilizzeremo il plugin File Manager ma potrai seguire la spiegazione indipendentemente dal metodo che scegli.

Innanzitutto, apri la cartella wp-content . Lì vedrai un nuovo file chiamato debug.log che contiene il registro di tutti gli errori.

registro di debug del contenuto wp

Apri il file e vedrai tutti gli errori che devi correggere con la loro data e ora.

registro degli errori

NOTA: l'abilitazione della modalità di debug e la risoluzione dei problemi su un sito Web live non è una pratica consigliata. Invece, puoi creare un ambiente di staging ed eseguire lì tutti i test necessari. Una volta che hai la soluzione, puoi applicarla al tuo sito live. La maggior parte delle società di hosting WordPress offre ambienti di staging gratuiti per scopi di test e sviluppo, quindi non dovrebbe essere difficile.

Conclusione

Tutto sommato, per impostazione predefinita, WordPress non ha una funzione integrata per monitorare bug e conflitti. Questo rende difficile sapere qual è il problema e quindi risolverlo.

La modalità di debug consente di trovare bug ed errori e risolverli rapidamente. In questa guida, abbiamo visto due modi diversi per abilitare la modalità di debug in WordPress:

  • Manualmente con un po' di codice
  • Con un plug-in

Se ti senti a tuo agio nella modifica dei file core, puoi attivare manualmente la modalità di debug con poche righe di codice. Questo metodo è semplice e non influisce sulla velocità e sulle prestazioni del tuo sito web. D'altra parte, puoi utilizzare un plug-in per attivare la modalità di debug senza dover modificare alcun file principale. Questo metodo è perfetto per i principianti in quanto ti consente di avere la modalità di debug attiva e funzionante in pochi clic. Entrambi i metodi sono efficaci, quindi scegli quello più adatto alle tue esigenze e preferenze.

Infine, se vuoi imparare a risolvere alcuni dei problemi più comuni di WordPress, dai un'occhiata alle seguenti guide:

  • L'accesso a WordPress non funziona? Come sistemarlo
  • Come riparare i permalink di WordPress
  • Correggi l'errore di aggiornamento di WordPress non riuscito
  • Come risolvere il collegamento che hai seguito è scaduto errore in WordPress

Hai abilitato la modalità debug sul tuo sito? Quale metodo hai usato? Fateci sapere nei commenti qui sotto!