Debug log WordPress: come trovare errori PHP senza mostrare avvisi ai visitatori

Di | Pubblicato il: 20 Novembre 2026 | Categorie: Wordpress | Ultimo aggiornamento: 20 Novembre 2026 | Tempo di lettura: 11 min |

 

Una schermata bianca, un messaggio di errore critico o un HTTP 500 non indicano automaticamente un problema di WordPress core. Possono dipendere da codice PHP, un tema, un plugin, una configurazione del server o una richiesta AJAX che fallisce.

Il modo più affidabile per iniziare è raccogliere un errore collegato a un’azione precisa. Il debug log WordPress serve a registrare questi dettagli senza stamparli nelle pagine pubbliche. Se il log non basta, bisogna passare ai log PHP e del server oppure agli strumenti del browser.

Lavora preferibilmente su staging. Sul sito live, abilita il debug solo per il tempo strettamente necessario e non lasciare mai warning, percorsi interni o stack trace visibili ai visitatori.

Prima di iniziare: lavora su staging o prepara un ripristino

Uno staging o un ambiente locale permette di riprodurre l’errore senza intervenire sul sito pubblico. È la scelta migliore se il problema riguarda un aggiornamento, un’area riservata, un checkout o una funzione che potrebbe essere usata dai clienti.

Se devi verificare il problema direttamente in produzione, crea prima un backup verificabile di file e database. Annota anche le informazioni che serviranno a correlare l’errore: versione di WordPress e PHP, componenti aggiornati di recente, ora del test e azione che genera il malfunzionamento.

Evita di attivare una visualizzazione pubblica degli errori per “capire cosa succede”. Un avviso PHP può rivelare percorsi assoluti, nomi di plugin, versioni e dettagli di implementazione. Per la preparazione dell’ambiente, può essere utile affiancare questa procedura a una guida interna dedicata a staging e backup.

Attivare debug.log in modo sicuro senza mostrare errori nel frontend

Lo snippet da inserire in wp-config.php

Apri il file wp-config.php e inserisci questo blocco prima del commento finale “That’s all, stop editing”:

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Salva il file e riproduci il problema una sola volta. Con la configurazione predefinita, WordPress dovrebbe creare o aggiornare il file wp-content/debug.log.

Cosa fanno le costanti

WP_DEBUG abilita la modalità di debug WordPress e il reporting degli errori PHP durante il bootstrap. È l’impostazione da cui dipendono le altre due.

WP_DEBUG_LOG invia gli errori al log. Con il valore true, il percorso abituale è /wp-content/debug.log. WP_DEBUG_DISPLAY impostato su false evita che WordPress stampi i messaggi nell’HTML della pagina.

@ini_set( 'display_errors', 0 ) aggiunge una protezione contro la visualizzazione degli errori PHP. Non sostituisce però la configurazione dell’hosting: un’impostazione PHP o PHP-FPM prevalente, oppure un errore che avviene prima del caricamento di WordPress, può continuare a produrre output. La documentazione di WordPress sul debugging raccomanda di non usare la visualizzazione degli errori su un sito pubblico.

Attenzione a true e false: non usare stringhe

Le costanti devono ricevere valori booleani, non testo. Questo esempio è errato:

define( 'WP_DEBUG', 'false' ); // errato

In PHP una stringa non vuota, anche se contiene la parola false, viene valutata come vera. Per disabilitare il debug devi usare false senza virgolette.

Dove trovare debug.log e come evitare che esponga dati tecnici

Percorso predefinito e log in percorso privato

Il percorso standard è:

/wp-content/debug.log

Poiché wp-content è normalmente sotto la directory pubblica del sito, non dare per scontato che il file sia inaccessibile via HTTP. Un log può contenere percorsi assoluti del server, nomi di componenti, endpoint, query e stack trace.

Quando l’hosting lo consente, è preferibile usare una destinazione privata, fuori dalla web root. Sostituisci in quel caso la riga WP_DEBUG_LOG precedente con un percorso reale, esistente e scrivibile dal processo PHP:

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

Non esiste un percorso universale: dipende dal provider, dal pannello di controllo e dalla configurazione del server. Evita inoltre di impostare due definizioni diverse della stessa costante nel file.

Dati da non esporre o copiare online

Non pubblicare il file completo in forum, chat o ticket. Se devi chiedere assistenza, condividi solo le righe necessarie, dopo aver rimosso dati riservati. Non inserire volontariamente nei log password, token, cookie, dati personali o contenuti dei moduli.

Al termine dell’analisi, cancella il log oppure archivialo in un’area privata. Verifica anche che non sia scaricabile dal browser.

Riprodurre l’errore una volta e leggere le righe che contano

Metodo pratico: azione, orario, controllo del log

Un file storico può contenere decine di notice e deprecazioni senza relazione con il problema attuale. Per non inseguire falsi indizi, collega sempre un’azione a un orario.

  1. Salva una copia del log esistente se contiene informazioni utili.
  2. Scegli una sola azione riproducibile: aprire una URL, salvare un articolo, inviare un form o eseguire un’operazione nell’area amministrativa.
  3. Annota l’ora precisa del test.
  4. Apri il log e cerca le righe nuove compatibili con quell’intervallo.
  5. Correggi il problema, ripeti la stessa azione e verifica se l’errore è scomparso.

Per editor, richieste REST e AJAX, apri prima gli strumenti per sviluppatori del browser: l’orario di una risposta HTTP 500 nel pannello Network è molto utile per individuare la riga corrispondente nei log.

Come interpretare una riga di errore PHP

Questo esempio è illustrativo:

[11-Nov-2026 10:24:18 UTC] PHP Fatal error: Uncaught Error:
Call to undefined function vendor_plugin_function()
in /var/www/example.com/wp-content/plugins/nome-plugin/file.php:123

Il timestamp indica quando è stato registrato l’evento: deve coincidere con il tuo test. PHP Fatal error segnala un errore che può interrompere la richiesta. Il messaggio descrive la condizione rilevata, qui una funzione non disponibile.

Il percorso porta al file da cui iniziare: nell’esempio è un plugin, mentre potrebbe essere il tema, un mu-plugin, codice personalizzato o il core. Il numero dopo i due punti è la riga interessata. Quando presente, lo stack trace mostra la sequenza di chiamate che ha portato all’errore.

Il file riportato non è sempre la causa definitiva. Un plugin può fallire perché una dipendenza non è stata caricata, perché il codice è incompatibile con la versione PHP o perché un altro componente ha alterato il flusso. Il log è una prova da verificare, non un verdetto automatico.

Quali errori analizzare prima

Parti da Fatal error, Uncaught Error, eccezioni non gestite e Parse error: sono spesso compatibili con schermate bianche e errori 500. Subito dopo valuta memoria esaurita, timeout e messaggi su funzioni o classi mancanti.

Deprecated, warning e notice sono segnali utili per aggiornare o correggere codice, ma non sono necessariamente la causa del blocco. Considerali prioritari solo se compaiono all’ora del test e il comportamento è riproducibile. Se il percorso punta a un componente aggiornato di recente, approfondisci poi con la procedura interna per isolare conflitti tra plugin e tema.

Quando debug.log non basta: scegli la fonte diagnostica corretta

Debug log WordPress, log del server o Console del browser?

Fonte Cosa può rivelare Quando consultarla Limiti
debug.log Errori PHP di plugin, temi, codice personalizzato, REST, AJAX e parte delle attività cron. Il problema avviene dopo il caricamento di WordPress. Può non registrare errori precedenti al bootstrap o gestiti dal server.
Log PHP, PHP-FPM, Apache o Nginx Avvio PHP, estensioni mancanti, 502/503/504, timeout, proxy e problemi infrastrutturali. debug.log è vuoto, incompleto o la richiesta non raggiunge WordPress. Posizione e accesso dipendono dall’hosting.
Console e Network del browser Errori JavaScript, risorse bloccate, richieste REST/AJAX e stati 401, 403, 404 o 500. Editor non salva, interfaccia bloccata o funzione che fallisce nel browser. Non sostituisce i log PHP per individuare la causa lato server.

 
I log server si trovano di solito nel pannello hosting, nel file manager, via SSH o nella dashboard dell’infrastruttura. PHP usa la propria configurazione error_log; PHP-FPM, Apache e Nginx possono avere log separati. Chiedi al provider dove consultarli invece di cercare percorsi standard non adatti al tuo ambiente.

Se debug.log è vuoto o non viene creato

Verifica prima di aver riprodotto davvero il problema dopo l’attivazione. Controlla poi che lo snippet sia prima del commento finale di wp-config.php, che non esistano definizioni duplicate e che WP_DEBUG sia il booleano true.

Il percorso potrebbe non essere scrivibile, il file potrebbe essere gestito diversamente dall’hosting oppure l’errore potrebbe verificarsi prima del bootstrap WordPress. In questi casi, passa ai log PHP e web server.

Se gli avvisi sono ancora visibili

Cerca configurazioni duplicate e verifica display_errors nel pannello hosting, in eventuali file .user.ini e nelle impostazioni PHP-FPM o FastCGI. Un plugin o tema può anche produrre output diretto. WordPress non può controllare con certezza errori anteriori al proprio caricamento né impostazioni server che prevalgono sulle sue costanti.

Recovery Mode: utile per rientrare nell’area admin

In alcuni fatal error durante il caricamento normale di una pagina, WordPress può inviare all’amministratore un link di Recovery Mode. Consente di accedere con il componente problematico sospeso per quella sessione. È utile per recuperare l’accesso, ma non è garantito per cron e processi in background e non sostituisce la lettura dei log.

Dopo la diagnosi: disattiva il debug e proteggi il log

Configurazione da ripristinare

Dopo aver corretto e verificato il problema, sostituisci la configurazione temporanea con questa:

define( 'WP_DEBUG', false );
define( 'WP_DEBUG_LOG', false );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Controlla che nel file non rimangano altre definizioni di queste costanti. Due configurazioni in punti diversi rendono difficile capire quale valore sia effettivamente applicato.

Verifica finale e prossimo passo

Rimuovi il file di log o spostalo in un’area privata. Testa frontend, amministrazione e funzione coinvolta anche da una sessione non autenticata, quindi verifica che il log non sia raggiungibile via browser.

Se il problema resta, raccogli l’orario del test, il messaggio esatto, la versione PHP e il componente indicato nel percorso. Sono informazioni sufficienti per aprire un ticket utile con l’hosting o affidare l’analisi a un servizio di assistenza WordPress, senza esporre pubblicamente dati tecnici del sito.

Condividi questo articolo

Autore: Enrico

Ciao, mi chiamo Enrico Cecchini, ho sempre avuto la passione dei computer, fin da quando ero piccolo. Ho fatto di questa passione la mia professione e dopo aver conseguito la laurea in ingegneria informatica ho iniziato a sviluppare siti web. Ho creato Mywebfriend per aiutare a risolvere dubbi e problemi che nascono utilizzando il computer.
Torna in cima