Su quasi tutti i siti WordPress che prendo in carico c’è un file di log degli errori PHP che nessuno ha mai aperto. A seconda dell’hosting si chiama error_log o php_errorlog (oppure debug.log, se è attivo il debug di WordPress) e si trova nella cartella principale del sito, in wp-content o in una cartella dei log dell’hosting. A volte pesa pochi kilobyte, a volte qualche gigabyte.
Il sito sembra funzionare, quindi nessuno ci guarda. Eppure quel file dice parecchie cose su come sta il sito.
Perché si riempie
PHP scrive nel log quattro tipi principali di messaggi: gli errori fatali, che bloccano la pagina; i warning, che segnalano qualcosa che non va ma lasciano proseguire; i notice, che segnalano cose più piccole come una variabile non definita; i deprecated, che avvisano che una funzione verrà rimossa nelle prossime versioni di PHP.
Molti plugin commerciali, anche costosi e molto diffusi, generano warning e notice a ogni pagina: l’indice di un array che non esiste, una variabile usata prima di essere definita, una funzione chiamata con parametri vecchi. Ogni messaggio da solo non fa danni visibili, ma su un sito con un po’ di visite diventano migliaia di righe al giorno.
Perché va letto
Il primo motivo è che in mezzo a migliaia di notice si perdono i messaggi che contano. Un errore fatale che si presenta solo nel checkout, o solo quando un certo tipo di utente fa login, finisce sepolto sotto righe tutte uguali, e nessuno se ne accorge finché un cliente non telefona.
Il secondo motivo è la velocità. Scrivere nel log è un’operazione sul disco, e se avviene molte volte per ogni pagina caricata pesa sui tempi di risposta. Il file poi cresce senza limiti, occupa spazio e rallenta i backup. Correggendo le poche righe di codice che generano la maggior parte dei messaggi, quel lavoro inutile sparisce.
Come lo leggo
Aprire un file di qualche gigabyte con un editor non serve a molto. Prima ne scarico una copia, poi lo raggruppo: tolgo la data e l’ora all’inizio di ogni riga, così i messaggi identici diventano righe identiche, e li conto. Da terminale, su Linux, uso una riga di questo tipo:
sed -E 's/^\[[^]]*\] //' error_log | sort | uniq -c | sort -rn | head -50
Il risultato è l’elenco dei messaggi diversi, dal più frequente al meno frequente, ognuno con il numero di volte in cui compare. Di solito poche righe coprono quasi tutto il file. Ogni messaggio riporta il percorso del file e il numero di riga che lo hanno generato, e dal percorso capisco subito se arriva dal tema, da un plugin (e quale) o dal core di WordPress.
Poi guardo a parte gli errori fatali, anche se sono pochi, perché sono quelli che un visitatore vede come pagina bianca o come errore critico:
grep "PHP Fatal" error_log | sed -E 's/^\[[^]]*\] //' | sort | uniq -c | sort -rn
Se non c’è accesso al terminale, il plugin che ho scritto per abilitare e leggere i log permette di vederli dall’amministrazione di WordPress.
Cosa correggo e cosa segnalo
Gli errori che arrivano dal tema o da plugin scritti su misura li correggo direttamente. Di solito si tratta di aggiungere un controllo prima di leggere un valore, o di sostituire una funzione deprecata con quella nuova.
Gli errori dei plugin commerciali invece non li correggo nel codice del plugin, perché al primo aggiornamento le modifiche verrebbero cancellate (ne ho parlato nell’articolo su come modificare plugin su WordPress). Prima controllo se esiste già una versione più recente che li risolve; se non c’è, li segnalo allo sviluppatore con il messaggio esatto, il file e la riga, la versione del plugin, di WordPress e di PHP. Una segnalazione così si può riprodurre e di solito viene presa in considerazione; un generico “il vostro plugin dà errori” quasi mai.
Nell’attesa, se si tratta di notice o deprecated e il log è diventato illeggibile, si può ridurre il livello di dettaglio del log sul sito pubblico, lasciando registrati warning ed errori fatali. La considero una soluzione temporanea, e sulla copia di prova tengo comunque il log completo.
Ogni quanto lo apro
Lo leggo quando prendo in carico un sito, dopo ogni giro di aggiornamenti e quando qualcuno segnala un problema. Per cercare l’origine di un problema preciso conviene invece attivare il debug di WordPress come ho spiegato in debuggare problemi in WordPress: i messaggi finiscono in un file separato, più piccolo e più facile da leggere.


