Ogni sito WordPress ha errori. Notifiche PHP, fallimenti di query del database, conflitti di plugin, timeout del server — accadono costantemente. La differenza tra un sito ben mantenuto e uno trascurato non è l'assenza di errori; è saperne prima dei tuoi utenti.
La registrazione e il monitoraggio degli errori ti danno visibilità su cosa sta accadendo sul tuo sito. Per gli sviluppatori di plugin, questo è particolarmente importante — non puoi correggere bug di cui non sai nulla. Questa guida copre come configurare la registrazione e il monitoraggio a ogni livello, dallo sviluppo locale alla produzione.
WP_DEBUG: Le Fondamenta
Il sistema di debug integrato di WordPress inizia con WP_DEBUG. Quando è abilitato in wp-config.php, mostra errori PHP, warning e notifiche direttamente sulla pagina. Questo è essenziale durante lo sviluppo ma non dovrebbe mai essere abilitato su un sito di produzione.
Per gli ambienti di sviluppo, abilita WP_DEBUG insieme a WP_DEBUG_LOG e WP_DEBUG_DISPLAY. WP_DEBUG_LOG scrive gli errori in un file in /wp-content/debug.log, e WP_DEBUG_DISPLAY li mostra sulla pagina. Per gli ambienti di staging, abilita WP_DEBUG_LOG ma disabilita WP_DEBUG_DISPLAY — registra gli errori per la revisione ma non mostrarli agli utenti.
Query Monitor: Il Coltellino Svizzero
Query Monitor è il plugin di debug più utile per lo sviluppo WordPress. Aggiunge una barra degli strumenti admin che mostra le query del database, gli hook, le richieste HTTP, i dati dell'editor a blocchi e gli errori PHP — tutto organizzato per una facile ispezione.
Per gli sviluppatori di plugin, il pannello delle query del database di Query Monitor è inestimabile. Mostra ogni query eseguita sulla pagina, quanto tempo ha impiegato ciascuna e quale funzione l'ha attivata. Questo rende facile identificare query poco performanti, query duplicate e colli di bottiglia del database.
Log degli Errori a Livello di Server
Il tuo server web (Apache, Nginx, LiteSpeed) mantiene i propri log degli errori. Questi catturano i problemi che accadono prima che WordPress si carichi — errori PHP fatali, esaurimento dei limiti di memoria e problemi di configurazione del server che WP_DEBUG non può rilevare.
Accedi ai log degli errori del server tramite il pannello di controllo del tuo hosting o via SSH. Cerca pattern: errori PHP fatali ripetuti, fallimenti di allocazione della memoria e voci di errore 500 Internal Server Error. Questi log sono spesso il primo posto in cui appare un problema, e controllarli regolarmente può cogliere i problemi prima che colpiscano gli utenti.
Monitoraggio degli Errori con Sentry
Per i siti di produzione e i plugin, un servizio di monitoraggio degli errori dedicato come Sentry è lo standard d'oro. Sentry cattura gli errori in tempo reale, raggruppa errori simili e fornisce contesto dettagliato includendo stack trace, dati utente e informazioni sull'ambiente.
Per i plugin WordPress, l'SDK PHP di Sentry può essere integrato per catturare gli errori che accadono nel codice del tuo plugin. Configura l'SDK nell'inizializzazione del tuo plugin, configuralo con il tuo DSN (Data Source Name) e riporterà automaticamente le eccezioni non catturate e gli errori PHP. Il plugin WordPress di Sentry semplifica ulteriormente questa integrazione.
Monitoraggio dell'Uptime
Il monitoraggio dell'uptime verifica se il tuo sito è accessibile da più posizioni in tutto il mondo. Servizi come Pingdom, UptimeRobot e Better Uptime pingano il tuo sito a intervalli regolari e ti avvisano se è giù.
Configura il tuo monitor di uptime per controllare il tuo sito ogni 1-5 minuti da almeno due posizioni. Imposta notifiche via email, SMS, Slack o il tuo canale preferito. Per gli sviluppatori di plugin, il monitoraggio dell'uptime è importante non solo per il tuo sito ma per garantire che il server di aggiornamento del tuo plugin, gli endpoint API e il sistema di licenze rimangano accessibili.
Monitoraggio delle Prestazioni
Il monitoraggio delle prestazioni traccia la velocità del tuo sito nel tempo e ti avvisa quando si degrada. Strumenti come Chrome User Experience Report, Lighthouse CI e WebPageTest possono essere programmati per eseguire test di prestazioni regolari.
Per gli sviluppatori di plugin, il monitoraggio delle prestazioni aiuta a cogliere le regressioni quando rilasci nuove versioni. Un aggiornamento del plugin che aggiunge una query non ottimizzata apparirà nelle tue metriche di prestazioni. Imposta un budget di prestazioni — tempo massimo di caricamento della pagina, numero massimo di query — e avvisa quando il tuo plugin lo supera.
Il punto fondamentale
La registrazione e il monitoraggio degli errori non sono facoltativi per lo sviluppo WordPress professionale. Come minimo, abilita WP_DEBUG_LOG sugli ambienti di staging, installa Query Monitor per lo sviluppo e controlla i log degli errori del server settimanalmente. Per i siti di produzione e i plugin, investi in un servizio come Sentry per il tracciamento degli errori in tempo reale e in un servizio di monitoraggio dell'uptime per gli avvisi di disponibilità.
Il costo del monitoraggio è trascurabile rispetto al costo di un bug che rimane non rilevato per settimane. Gli errori accadono. La domanda è se li trovi tu o i tuoi utenti.
