Attenzione!

Questo articolo contiene codice PHP ed è destinato agli sviluppatori. Offriamo questo codice come cortesia, ma non forniamo supporto per personalizzazioni del codice o sviluppo di terze parti.

Per ulteriore assistenza, consulta il tutorial di WPBeginner su come aggiungere codice personalizzato.

Chiudi

Come abilitare il debug in WordPress

Quando si risolvono problemi con plugin, temi o codice personalizzato di WordPress, potrebbe essere necessario abilitare il debug di WordPress. Questa funzione registra eventuali errori rilevati sul tuo sito, aiutandoti a identificare la fonte dei problemi o a raccogliere maggiori dettagli su potenziali problemi.

Questa guida ti mostrerà come abilitare in modo sicuro il debug sul tuo sito WordPress.

Abilitare il debug in WordPress

Per abilitare il debug sul tuo sito, segui i passaggi seguenti.

1) Individuare il file wp-config.php

Per impostazione predefinita, il debug di WordPress sarà disabilitato. Per abilitarlo, dovrai accedere ai file del tuo sito tramite FTP (File Transfer Protocol) o tramite il cPanel del tuo server.

Per saperne di più sull'FTP, dai un'occhiata a questo articolo di WPBeginner. In alternativa, i nostri amici di WPBeginner hanno anche un articolo sulle informazioni del cPanel, che puoi visualizzare qui.

In alternativa, puoi anche semplicemente installare un plugin come WP File Manager per accedere facilmente ai file del tuo server tramite l'area di amministrazione di WordPress. Per saperne di più su quel plugin dai un'occhiata al loro plugin su WordPress.org.

2) Modifica del file wp-config.php

Una volta aperti i file del tuo sito, dovrai aprire wp-config.php per la modifica.

Questo file si troverà nella cartella principale del tuo server. Per saperne di più sulla posizione e sulle istruzioni della directory, esamina questo articolo.

Apri il file wp-config per abilitare il debug in WordPress

Per ulteriori esempi su come modificare il file wp-config.php, consulta questo articolo di WPBeginner sulla modifica del file wp-config in WordPress.

Individua il file wp-config.php nella directory principale del tuo sito. Questo file contiene le impostazioni di configurazione principali del tuo sito.

Trova questa riga verso il fondo del file:

('WP_DEBUG', false);

3) Abilitazione del debug

Sostituiscila con questo snippet di codice con la configurazione del debug:

// Enable WP_DEBUG mode
define( 'WP_DEBUG', true );

// Enable Debug logging to the /wp-content/debug.log file
define( 'WP_DEBUG_LOG', true );

// Disable display of errors and warnings
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

// Use dev versions of core JS and CSS files (only needed if you are modifying these core files)
define( 'SCRIPT_DEBUG', true );

Nota: aggiungi questo codice prima della riga che dice "/* Fine. Smetti di modificare! Buon blogging. */"

abilita il debug all'interno del file wp-config.php

Ciò abiliterà il debug e, soprattutto, impedirà la visualizzazione di qualsiasi dato registrato sul tuo sito. Invece, un file di log di debug verrà salvato nei file del tuo sito.

4) Riproduzione del problema

Dopo aver salvato queste modifiche a wp-config.php, dovrai tornare sul tuo sito e riprodurre il problema che hai riscontrato in precedenza. Ciò garantirà che venga registrato nel nuovo file di log degli errori.

5) Visualizzazione del file di log di debug

Quindi, puoi tornare ai file del tuo sito e aprire https://tuonome-sito.com/wp-content/debug.log

Nota: Tieni presente che l'URL per il debug.log dipenderà esattamente da come è configurato il tuo sito. Ad esempio, se il tuo sito è installato in una sottodirectory, l'URL principale potrebbe apparire simile a questo: https://tuonome-sito.com/nome-tua-sottodirectory/wp-content/debug.log. Contatta la tua società di hosting se non sei sicuro di come accedere a questo file.

Il contenuto di un file di log degli errori può variare molto a seconda della causa e del numero di problemi, ma ora dovresti essere in grado di vedere dettagli aggiuntivi, come il percorso di un file all'origine di un errore di codice, per aiutarti a individuare meglio il problema.

Per informazioni più dettagliate sul debug di WordPress, consulta la Documentazione ufficiale sul debug di WordPress.