Sappiamo che WordPress è uno dei CMS più utilizzati e diffusi nel web. I continui update, gli aggiornamenti di core, temi e plugin o le modifiche che fai per ottimizzare il portale possono portare a problemi apparentemente difficili da risolvere. Per questo è importante capire come attivare la modalità debug su WordPress.
Cos’è la modalità debug sul CMS WordPress?
La modalità debug è l’impostazione che ti permette di individuare errori, avvisi e conflitti che di base resterebbero nascosti. Serve a capire perché un sito va in down: temi che non combaciano con i plugin, funzioni deprecate, query al database che non funzionano bene.
Quando è necessario attivare la modalità debug?
La modalità debug di WordPress è una condizione indispensabile quando non va in porto un aggiornamento automatico o manuale del core o di qualche plugin. E c'è un errore interno che impedisce la corretta visualizzazione come mostra l’esempio in basso.
Se il tuo sito web non è più visibile e ti mostra una pagina bianca - White Screen of Death, lo schermo bianco della morte - o un errore 500 è il momento di lanciare la modalità debug di WordPress. In che modo? Continua a leggere per approfondire.
Come attivare la modalità debug di WordPress
WordPress, di default, non visualizza errori interni per motivi di sicurezza. Infatti, tramite variabili visibili, paths e funzioni i cybercriminali potrebbero individuare falle di sicurezza e rovinare il lavoro svolto anche grazie al nostro hosting con WordPress preinstallato, dominio incluso e implementato dall’intelligenza artificiale.
Per visualizzare gli errori in sicurezza, puoi abilitare la modalità di debug interna tramite dei semplici passaggi. Ecco la procedura semplificata per agire su questo punto:
Vai sul portale https://www.serverplan.com/
Fai login sull’area clienti Serverplan.
Clicca sul nome del servizio hosting.
Accedi al tuo CPanel,
Clicca sull’icona del File Manager (o gestione file).
Così puoi accedere a tutti i file del tuo sito web, qui in basso hai uno screenshot che ti mostra dove devi cliccare. A questo punto devi intervenire nel file wp-config.php e impostare le costanti di debug. Continua a seguire le indicazioni per operare senza rischi.
Una volta nell’area di File Manager hai una lista di directory e documenti. Non temere, se segui le istruzioni non ci sono rischi di fare danni. Clicca due volte sulla cartella chiamata public_html. Questa è la directory che contiene tutti i file del tuo sito WordPress.
Ora hai un’ulteriore lista di file. Individua e seleziona il documento wp-config.php e clicca su Modifica (o Edit). Hai un testo pieno di codice, ignora tutto e cerca solo la stringa:
define('WP_DEBUG', false);La devi modificare così selezionando il termine false che vuol dire spento, inattivo, per portarlo su true. Ovvero attivo. Ecco il risultato finale che devi avere sul file:
define('WP_DEBUG', true);Una volta terminata l’operazione devi cliccare sul bottone salva per attivare la condizione di debug sul tuo sito web WordPress. Ricorda che questa non è una modalità da tenere sempre attiva, perché mostra informazioni sensibili e rallenta il portale.
In ogni caso, la modalità debug di WordPress è fondamentale quando devi individuare rapidamente la causa di un problema tecnico. Anche perché include strumenti come WP_DEBUG, già citato per individuare gli errori, ma anche WP_DEBUG_LOG che crea (o aggiorna) un file chiamato debug.log dentro la cartella wp-content e WP_DEBUG_DISPLAY che mostra sul browser gli errori del portale: sono tre costanti fondamentali.
Come sfruttare la modalità debug su WordPress
Una volta attivata, per avere le indicazioni necessarie alla risoluzione dei problemi devi solo visitare il tuo sito internet digitando il nome dominio sul browser. Al tuo sito web potrai visualizzare l'errore PHP che ti sta bloccando. Nell’esempio, il problema è generato dal tema.
Come disattivare la modalità debug
Hai avviato questa procedura e hai trovato il problema. Lo hai anche risolto. Disattivare la modalità debug di WordPress è altrettanto semplice: basta riportare le costanti nel file wp-config.php ai valori predefiniti. In pratica devi spegnere l’interruttore passando da:
define('WP_DEBUG', true);a
define('WP_DEBUG', false);Alternative per avviare la fase di debug
Ricorda che ci sono anche delle alternative per avviare la modalità debug, esistono dei plugin che consentono di risolvere questo passaggio senza intervenire sul File Manager come, ad esempio, Debugger & Troubleshooter o WP Debugging che hanno anche una modalità troubleshooting in sessione che ti consente di simulare la disattivazione di plugin o il cambio tema solo per il tuo browser, per capire meglio da dove viene il conflitto.
La nostra idea, però, è semplice: al posto di attivare l’ennesimo plugin che inserisce diverse funzioni - non sempre tutte utili e a volte in grado di appesantire la struttura - conviene fare una piccola modifica manuale per ottenere risultati puliti e utili.
Ricorda che puoi anche analizzare gli errori tracciati nei log seguendo questa guida che spiegacome vedere i log di errore su cPanel.
