WordPress Debug Mode - Suggerimenti per il debug del tuo sito web

WordPress Debug Mode - Suggerimenti per il debug del tuo sito web

Se sei arrivati a questo articolo, presumo che abbiate incontrato un errore sul vostro sito web WordPress . O che sei una persona che fa regolarmente manutenzione e si aspetta di incontrare un bug. In ogni caso, voglio ricordarvi che scrivere codice e scrivere bug vanno di pari passo. Anche i migliori sviluppatori commettono errori. Per non farvi disperare per questi errori, vi ho scritto questa guida su WordPress debug mode. Questo è uno strumento molto utile per scoprire e capire gli errori in WordPress . 

Il primo passo per il debug del tuo codice 

Sedetevi sulla vostra sedia, fate qualche respiro profondo ed espirate, e rendetevi conto che tutti gli sviluppatori hanno scritto codice difettoso ad un certo punto. Ogni volta che si scrive codice buggato, si impara qualcosa - e se si impara qualcosa, si continua a sviluppare e migliorare le proprie capacità. 

Mentre può sembrare che un bug sia lì solo per farti impazzire, per fortuna questo è relativamente improbabile 😉 La cosa buona è: a meno che tu non abbia a che fare con la tecnologia più recente, c'è una buona probabilità che qualcun altro abbia già incontrato lo stesso bug. 

Cos'è il debugging? 

Se non hai familiarità con il termine debugging, è letteralmente nel nome: de - bugging. Nel linguaggio informatico, un errore nel vostro codice si chiama bug. Quindi debuggare il vostro codice significa: rimuovere gli errori dal vostro codice. Anche se alla gente piace supporre che i bug siano causati dal proprio staff o da aggiornamenti software mal pensati, la verità è che molti bug portano la vostra stessa scrittura - ed è meglio venire a patti con loro all'inizio.

Perché il debugging di PHP sembra più complicato di quello di JavaScript

Forse sei abituati a fare il debug in un altro linguaggio, per esempio JavaScript. Un po' di confusione è che JavaScript viene eseguito solo dopo che il tuo sito web è stato reso - almeno questo è lo standard sul web e la ragione per cui inserisci il tuo file .js alla fine del documento HTML. Questo significa che il tuo sito web può ancora essere visualizzato anche se ci sono errori JavaScript. Se non lo notate o non controllate il log della vostra console, potreste anche non sapere che si è verificato un errore. 

Tuttavia, PHP è un linguaggio lato server e viene utilizzato per costruire il tuo sito web (anche se può fare molto di più). Quindi se c'è un errore nel tuo codice PHP, il tuo sito web potrebbe non caricarsi e i visitatori potrebbero non vedere alcun contenuto. Così, gli errori PHP sono di solito più evidenti. 

Debugging in WordPress con WP-Debug 

Cos'è la modalità di debug di WordPress ?

Se la modalità di debug di WP (a volte chiamata anche wp-debugger o wp-debug) è attivata, ti mostra errori, suggerimenti e avvertimenti segnalati dal sistema WordPress . Per impostazione predefinita, il wp-debugger è disabilitato. La costante PHP wp_debug è la variabile globale che indica lo stato della modalità di debug di WordPress tramite un booleano, cioè se è acceso o spento. 

Perché dovreste usare la modalità di debug di WordPress ?

Perché WordPress usa alcuni componenti di base diversi: 

Frontend - HTML / CSS

Backend - PHP / Database

Plugins - applicazioni PHP create da terzi

Può quindi essere abbastanza difficile scoprire cosa ha causato un problema sul tuo sito web. Il wp-debugger è uno strumento che permette di visualizzare o registrare gli errori. 

Prima di iniziare il debug, fate un backup! 

Un vecchio detto dice che "prevenire è meglio che curare". Questo significa che è meglio non far sorgere un problema in primo luogo. Per voi questo significa: mettete al sicuro i tuoi dati!

Un lavoro di manutenzione di 30 minuti può trasformarsi rapidamente in un incubo di 5 ore solo perché non è stato fatto un backup prima che qualcuno abbia fatto casino con i file interni.

Per fortuna, se ospiti il tuo sito web su Raidboxes , il backup viene fatto automaticamente! Basta andare sul tuo Dashboard, cliccare sulla scheda "Backups" e visualizzare tutti i tuoi backup giornalieri. 

panoramica dei tuoi backup nel vostro Raidboxes dashboard

Se vuoi fare delle modifiche e devi creare un backup manuale, clicca sul pulsante "Create manual backup" e dai un nome al backup. Suggerimento: scegliete un nome che abbia senso, in modo da poter riconoscere il backup in seguito. Ora puoi giocare con il tuo sito web quanto vuoi! Se qualcosa va storto, basta ripristinare il backup. 

come creare un backup manuale nel vostro Raidboxes dashboard

Attivare la modalità di debug di WordPress su Raidboxes

Nel tuo Raidboxes Dashboard puoi attivare il wp-debugger nelle impostazioni del tuo Box con un clic: 

come attivare il wp-debugger nel vostro Raidboxes dashboard

Se clicchi su WordPress Debug Logsdopo aver attivato il WP Debug Mode, puoi vedere nel Live Log quali errori vengono lanciati dal tuo sito WordPress . È possibile accedere al log di debug stesso sia tramite le impostazioni nella voce WP Debug (vedi schermata) o tramite lapanoramica BOX . Puoi anche accedere ai file di log di debug di WP via FTP: I tuoi file di log sono memorizzati nella cartella /wp-content/ nel file debug.log.

WordPress Debug Mode - Suggerimenti per il debug del tuo sito web

Puoi trovare maggiori informazioni sull'analisi degli errori del tuo sito WordPress su Raidboxes nel nostro centro di aiuto.

Hai bisogno di wp-config.php per il debug?

Su Raidboxes puoi attivare la modalità di debug di WordPress con un solo clic nel tuo Dashboard . Il wp-config.php è di sola lettura per ragioni di sicurezza. Tuttavia, nelle impostazioni del tuo Box sotto WordPress > wp-config.php è possibile memorizzare voci speciali se necessario.

Molto importante: usate questa funzione solo se sei sicuri di cosa fanno le voci. Modificare il wp-config.php può portare a un sito web difettoso. Prima di aggiungere una voce, dovreste quindi controllare se hai già creato un backup.

Nella prossima sezione spieghiamo come abilitare il WP Debug Mode tramite wp-config.php quando si sviluppa in locale.

Attivare WordPress Debug localmente 

Nel tuo sviluppo locale, puoi abilitare wp-debug modificando il file wp-config.php nella root della tua cartella WordPress e aggiungendo il seguente codice: 

// Dies aktiviert das Debugging.
define( 'WP_DEBUG', true );

Si può anche scoprire che questa dichiarazione è già stata aggiunta, ma il valore è falso. Se questo è il caso, impostatelo semplicemente su true. 

// Dies deaktiviert das Debugging.
define( 'WP_DEBUG', false );
dove si trova il tuo file wp-config
abilitare la modalità di debug di WordPress  in PHP

A questo punto vorrei sottolineare ancora una volta quanto sia importante avere un backup. Ora è un buon momento per controllare di nuovo.  

WordPress La modalità di debug è ora attiva - e ora?

Ora che il wp-debugger è attivato, gli errori vengono visualizzati direttamente nella finestra del browser (se WP_DEBUG_DISPLAY è impostato su true) - questa è sia una maledizione che una benedizione. Da un lato, puoi vedere gli errori, ma dall'altro, tutti gli utenti del tuo sito web possono vederli, il che non è ideale. Per darvi un esempio, ho aggiunto una piccola funzione sconosciuta al piè di pagina dello standard WordPress Themes "Twenty Twenty-One". 

Prima di attivare wp-debug: 

prima che la modalità di debug WordPress  sia attiva

Dopo aver attivato wp-debug: 

dopo l'attivazione della modalità debug di WordPress

Probabilmente non vuoi che i visitatori del tuo sito web vedano questo, vero? Il messaggio di errore non solo disturba il design, ma potrebbe anche rivelare informazioni sensibili. Per esempio, prima di apportare alcune modifiche all'output, veniva emesso il mio nome utente e con questa informazione qualsiasi hacker poteva lanciare un attacco. 

I tuoi errori sono registrati?

Se attivi WP-Debug, le informazioni sull'errore non vengono salvate, ma solo visualizzate. Per salvare queste informazioni, è necessario abilitare wp_debug_log - questo è coperto in modo più dettagliato più avanti nell'articolo.

Come attivare la modalità di debug di WordPress ed evitare che gli errori vengano visualizzati nel tuo codice HTML

Fortunatamente, c'è una soluzione a questo problema in WordPress . Aggiungi il seguente codice al tuo wp-config.php: 

define( 'WP_DEBUG_DISPLAY', false );

Questo eviterà che gli errori appaiano nel codice HTML del tuo sito web e risparmierà ai tuoi utenti l'incubo che potresti aver causato. L'ultimo pezzo del puzzle è come controllare gli errori senza pubblicarli. Benvenuti nella registrazione degli errori! 

Attivare la registrazione degli errori in WordPress 

Nel file wp-config.php, è necessario abilitare la registrazione degli errori da WordPress . Questo creerà un file .log con i registri e i dettagli degli errori che si sono verificati sul tuo sito web. 

define( 'WP_DEBUG_LOG', true );

Di solito trovi il file di log nella cartella wp-content del tuo sito web WordPress , a meno che tu non abbia un percorso di file valido per questo log come specificato di seguito: 

define( 'WP_DEBUG_LOG', '/tmp/wp-errors.log' );

Tuttavia, il mio log degli errori è stato scritto nella directory principale di WordPress . Quindi, se non trovate il vostro log degli errori nella cartella wp-content, dovreste cercare altrove:  

file di log nel file system

Revisione di un registro degli errori

I log degli errori vi danno indicazioni abbastanza chiare su cosa è andato storto. Ma solo perché una cosa è chiara non significa che la si capisca, quindi scomponiamola. 

esempio di una voce di registro da WordPress  modalità debug
  1. Ora dell'errore: [12-Apr-2021 20:32:47 UTC]
  2. Tipo di errore: errore fatale di PHP
  3. Causa dell'errore: Uncaught Error: chiamata alla funzione non definita writeMsg() in
  4. Dove si è verificato l'errore: /home/XXXXXXX/DEVELOPMENT/wp/wp-content/themes/twentytwentyone/footer.php:73

Nel caso vi stiate chiedendo qual è l'errore che ho inserito, ho definito un metodo errato chiamato writeMsg() nel file footer.php che causa un errore. 

Non dimenticare di disattivare!

Importante: non dimenticate di disattivare la modalità di debug di WordPress dopo la vostra analisi. Se lo lasciate attivo, WordPress scrive tutti gli errori che trova nel file debug.log. Se gli errori si verificano regolarmente, questo file può diventare troppo grande e consumare la vostra memoria.

Il registro degli errori di WordPress è troppo grande?

I registri degli errori possono crescere nel tempo se non sono controllati. Ricordate che non solo gli errori, ma anche gli avvertimenti e i suggerimenti sono registrati. Quando ci sono nuove versioni di PHP, certi metodi possono diventare obsoleti o addirittura Plugins possono non essere più supportati. In questo caso, verranno generati più errori. 

Normalmente, un registro degli errori dovrebbe avere solo pochi kB di dimensione, ma anche allora è noioso da cercare. Nei casi peggiori, gli errori vengono registrati in un file che è già di diversi MB e contiene migliaia di righe di testo. Oltre ad essere più confuso, questo porta a tempi di reazione più lenti del file di log e può rallentare enormemente la ricerca degli errori a causa dei tempi di attesa durante il caricamento del log. Cosa si può fare allora? 

Scarica il file per l'archiviazione e poi cancellalo! 

Se i log degli errori di WordPress sono stati attivati in wp-config.php e nessun file error.log può essere trovato, WordPress crea un file completamente nuovo e lo riempie con gli errori attuali.

Conclusione

Il debugging del codice rende lo sviluppo sia impegnativo che gratificante. Perché gli errori ti costringono a espandere le tue conoscenze, a sviluppare un atteggiamento positivo e a pensare fuori dagli schemi. Se hai domande o difficoltà con il debugging del tuo sito web WordPress , sentiti libero di lasciare un commento o di contattarci nella chat di supporto. Divertiti a fare il debug!

Ha altre domande?

Se hai altre domande su WordPress Debug Mode, sentiti libero di usare la funzione commenti! Sei interessato ad argomenti attuali su WordPress, web design e business online? Poi segui Raidboxes su Twitter, Facebook, LinkedIn o tramite la nostra newsletter.

Ti è piaciuto l'articolo?

Con la tua valutazione ci aiuti a migliorare ancora di più il nostro contenuto.

Scrivi un commento

Il tuo indirizzo e-mail non sarà pubblicato.