Log errori WordPress: dove trovare l'errore e cosa vogliono dire i messaggi
I log degli errori di WordPress sono file in cui server, WordPress e plugin registrano i dettagli degli errori: il messaggio, il file e la riga. Guarda in tre posti: debug.log nella cartella wp-content (dopo aver attivato la registrazione in wp-config.php), il pannello dell'hosting e WooCommerce → Stato → Log. Senza di loro, correggere un errore è andare a tentativi.
Autore: Il team TellMyShop. Una guida per i titolari di siti WordPress e negozi WooCommerce: la causa, la correzione a mano e lo stesso lavoro in una conversazione in chat.
Ultimo aggiornamento: · 6 min di lettura
Tre posti dove guardare
Ognuno di questi posti registra qualcosa di diverso. Controllali in quest'ordine, partendo dal più facile.
| Posto | Cosa ci finisce | Come arrivarci | Chi di solito ha accesso |
|---|---|---|---|
| WooCommerce → Stato → Log, file fatal-errors | errori fatali PHP con file e riga | la bacheca, se funziona | tu |
| debug.log in wp-content | errori, avvisi e notifiche di WordPress e dei plugin | file manager dell'hosting o FTP, con la registrazione attiva | tu o chi segue il sito |
| Log degli errori PHP sul server | errori PHP, anche quando WordPress non si carica affatto | pannello dell'hosting | l'hosting, a volte tu |
Un negozio WooCommerce ha un vantaggio: il log fatal-errors funziona senza scavare tra i file. È WooCommerce stesso a consigliare di partire da lì, come spiega la documentazione di WooCommerce su come trovare i log degli errori PHP.
Come attivare debug.log passo per passo
La registrazione in debug.log si attiva in wp-config.php. Quel file contiene la password del database, quindi lavora su una copia e con attenzione. Se non ti senti sicuro, chiedi all'hosting o a chi segue il sito.
- Fai una copia di wp-config.php nel file manager dell'hosting.
- Apri wp-config.php in modifica e trova la riga con WP_DEBUG.
- Imposta WP_DEBUG su true, aggiungi WP_DEBUG_LOG impostato su true e WP_DEBUG_DISPLAY impostato su false.
- Salva il file e ripeti ciò che fa scattare l'errore, per esempio apri la pagina o aggiungi un prodotto al carrello.
- Apri wp-content/debug.log e leggi le ultime righe.
- Quando hai finito, rimetti WP_DEBUG su false.
Tutte le costanti e cosa fanno sono descritte nel manuale di WordPress sul debug. Una breve spiegazione del file stesso è nella voce del glossario di GreenGeeks su WP Debug Log.
Il file debug.log sta in una cartella che a volte si raggiunge da un browser. Non lasciare la registrazione sempre attiva senza motivo, oppure chiedi all'hosting di bloccare l'accesso a quel file.
Come leggere una voce del log
Ogni voce ha una forma simile: data e ora, livello dell'errore, messaggio e alla fine il percorso del file e il numero di riga. Il percorso è la cosa più importante. Se contiene wp-content/plugins/nome-plugin, la colpa è di quel plugin. Se è wp-content/themes/nome-tema, del tema.
I livelli, dal più grave:
- Fatal error: il codice si è fermato, e la pagina o una sua parte non funziona.
- Warning: qualcosa è andato storto, ma la pagina prosegue.
- Notice e Deprecated: note per gli sviluppatori, di solito senza effetti per i visitatori.
Glossario: cinque messaggi comuni
Allowed memory size of … bytes exhausted. PHP ha finito la memoria che gli era stata data. Può essere colpa di un plugin pesante o di un limite basso dell'hosting. Il limite di memoria lo alza l'hosting o chi segue il sito.
Call to undefined function … Il codice chiama una funzione che non esiste. Una causa comune è un plugin che dipende da un altro plugin disattivato, o un tema che dopo un aggiornamento non va più d'accordo con un plugin.
Maximum execution time of … seconds exceeded. Uno script è durato più di quanto il server consente. Succede durante un'importazione, un grande backup o una connessione lenta a un servizio esterno.
Uncaught Error: Class … not found. Manca una parte del codice di un plugin, per esempio dopo un aggiornamento non riuscito. Aiuta reinstallare la stessa versione del plugin.
Cannot modify header information - headers already sent. Qualcosa ha mandato testo al browser troppo presto. Molto spesso è una riga vuota o uno spazio alla fine di functions.php dopo una modifica manuale.
I valori nei messaggi cambiano da sito a sito, quindi sono sostituiti da puntini. Se il log mostra un errore fatale e il sito non va, passa alla guida sull'errore critico di WordPress. Per una schermata bianca o un codice 500, leggi l'articolo sull'errore 500 in WordPress.
Cosa mandare all'hosting o allo sviluppatore
Una segnalazione scritta bene risparmia diversi giri di messaggi. Includi:
- il messaggio esatto dal log, copiato e non riscritto a memoria, con il percorso del file e il numero di riga,
- la data e l'ora in cui è comparso la prima volta, e se l'errore continua a ripetersi,
- cosa è cambiato subito prima: aggiornamento di un plugin, del tema, di WordPress o della versione PHP,
- in quale pagina e durante quale azione compare l'errore, per esempio aggiungendo al carrello,
- le versioni di WordPress e PHP da Strumenti → Salute del sito → Info.
Prima di inviare, togli dall'estratto indirizzi email e altri dati dei clienti.
Come la chat legge i log per te
Il plugin TellMyShop per WordPress e WooCommerce legge i log degli errori già in TellMyShop Free. La tua chat (Claude o ChatGPT) riceve gli errori PHP, WordPress e WooCommerce degli ultimi giorni, raggruppati: lo stesso messaggio è una riga con un conteggio e la data dell'ultima volta. Per ognuno indica il plugin o il tema da cui viene e spiega il messaggio con parole semplici. Email, numeri di telefono e indirizzi IP nei log sono mascherati.
Tu: Da ieri il carrello a volte non si carica. Dai un'occhiata ai log.
La tua chat: Negli ultimi due giorni c'è un errore fatale, ripetuto una decina di volte:
Allowed memory size exhausted, in un file del plugin per il calcolo delle spedizioni.
Compare solo quando si apre il carrello. Ieri il plugin ha ricevuto una nuova versione.
Il mio consiglio: segnala l'errore all'autore o torna alla versione precedente del plugin. Il limite di memoria è una questione per il tuo hosting.
Il risultato in questa conversazione è un esempio. La chat legge ciò che è stato registrato. Se la registrazione in debug.log è spenta, nel log di WordPress non ci sarà niente. La chat non può attivarla: wp-config.php è sempre bloccato per il plugin, in ogni versione. Quello spetta a te, all'hosting o a chi segue il sito.
Leggere i log, lo stato di salute del sito e l'elenco dei plugin basta per una diagnosi, ed è gratis. Quando la causa è un plugin, in TellMyShop Pro la chat può disattivarlo o aggiornarlo quando accendi l'interruttore Plugin per 24 ore, sempre con un'anteprima e dopo la tua approvazione. La versione gratuita la scarichi dalla pagina TellMyShop Free, Pro è descritto nella pagina TellMyShop per WordPress e WooCommerce e le differenze sono nella pagina prezzi.
Domande e risposte
Dove si trova il file debug.log in WordPress?
Di default nella cartella wp-content, ma solo quando WP_DEBUG e WP_DEBUG_LOG sono attivi in wp-config.php. Il file viene creato al primo errore dopo l'attivazione della registrazione. Se non c'è, la registrazione è spenta oppure dall'attivazione non ci sono stati errori.
Attivare WP_DEBUG mostra gli errori ai clienti?
Può farlo, se lasci attiva la visualizzazione degli errori. Su un sito attivo registri su file con la visualizzazione spenta, cioè WP_DEBUG_DISPLAY impostato su false. Allora gli errori finiscono solo in debug.log.
Gli avvisi Deprecated vanno corretti subito?
Di solito no. Dicono che un plugin o un tema usa una funzione che in futuro sparirà da PHP o da WordPress. Il sito funziona, ma prima di cambiare versione PHP conviene segnalarli all'autore del plugin o cercare un aggiornamento.
Un log degli errori può contenere dati dei clienti?
Sì, a volte ci finiscono indirizzi email, indirizzi IP o pezzi di richieste. Quindi non pubblicare il file intero su un forum e non lasciare la registrazione attiva senza motivo. Il plugin TellMyShop maschera email, numeri di telefono e indirizzi IP quando legge i log.
Chi ha accesso ai log del server?
Il tuo hosting. I log degli errori PHP del server di solito sono nel pannello dell'hosting, nella sezione statistiche o log. Se lì non li vedi, chiedi all'assistenza l'estratto del momento in cui è comparso l'errore.
WordPress è un marchio della WordPress Foundation. WooCommerce è un marchio di Automattic Inc. Claude è un marchio di Anthropic PBC. ChatGPT e OpenAI sono marchi di OpenAI. TellMyShop non è affiliato a queste aziende.