Debug WordPress per sviluppatori: diagnosticare problemi senza impazzire

Il debug su WordPress: cercare un ago in un pagliaio di plugin

Il sito mostra una pagina bianca. Un form non invia. Il menu scompare su mobile. Un plugin genera un errore PHP. WooCommerce non calcola la spedizione. Con 20 plugin, un tema, e WordPress core: quale è il colpevole? Il debug tradizionale su WordPress è un processo per esclusione: disattivi i plugin uno alla volta, cambi tema, abiliti WP_DEBUG, leggi il log. Funziona ma è lento: su un sito con 20 plugin, il debug per esclusione può richiedere ore. Servono strumenti che puntano direttamente al problema.

Gli strumenti di debug essenziali

WP_DEBUG: il primo step (ma non basta)

In wp-config.php: define('WP_DEBUG', true); define('WP_DEBUG_LOG', true); define('WP_DEBUG_DISPLAY', false); Questo logga tutti gli errori PHP in wp-content/debug.log senza mostrarli ai visitatori. Il problema: WP_DEBUG mostra TUTTI gli errori, inclusi notice e deprecation warning innocui. Su un sito con molti plugin, il log si riempie di rumore e il problema reale è sepolto tra centinaia di righe irrilevanti. Serve un filtro intelligente che distingue gli errori critici dal rumore.

Query Monitor: il microscopio per WordPress

Query Monitor (plugin gratuito) mostra in tempo reale: tutte le query database con tempo di esecuzione (le query lente sono spesso la causa di siti lenti), gli hook attivi e chi li ha registrati, le richieste HTTP esterne, i template caricati, e gli errori PHP filtrati per gravità. È lo strumento più potente per il debug WordPress — ma va usato solo in sviluppo (aggiunge overhead) e richiede competenze per interpretare i dati.

Il modulo Debug di LANGA Tools

Diagnostica guidata per non-esperti

A differenza di Query Monitor (progettato per sviluppatori), il modulo Debug di LANGA Tools è progettato per chi gestisce il sito: diagnostica guidata che ti dice cosa è rotto e perché, non un dump di dati tecnici che devi interpretare. "Il plugin XYZ sta generando un errore fatale nella funzione ABC. Azione suggerita: aggiorna il plugin o disattivalo." Non "PHP Fatal error: Call to undefined function abc() in /path/to/plugin.php on line 123" — che è la stessa informazione ma incomprensibile per chi non è sviluppatore.

Health check senza overhead

Il modulo esegue un health check del sito su richiesta (non a ogni visita): versione PHP compatibile? Limiti di memoria sufficienti? Errori nel log? Plugin con conflitti noti? Tabelle database corrotte? Cron funzionante? Il risultato è un report chiaro con stato verde/giallo/rosso per ogni area e l'azione suggerita per ogni problema. Non serve sapere cos'è il "memory limit PHP": serve sapere se è un problema e come fixarlo.

Conflict detector

Quando attivi un nuovo plugin e qualcosa si rompe: il conflict detector identifica quale plugin esistente è in conflitto con quello nuovo. Invece di disattivare 20 plugin uno alla volta, il detector li testa in combinazioni e identifica il conflitto specifico. "Il plugin A e il plugin B definiscono entrambi la funzione xyz() — conflitto." Il tempo di debug passa da 2 ore a 2 minuti.

Quando chiamare un professionista

Il modulo Debug risolve l'80% dei problemi WordPress: errori plugin, conflitti, configurazione, performance. Per il 20% restante (problemi di codice custom, database corrotto, hack avanzato, configurazione server) serve un professionista. Ma il modulo Debug ti dice quale 20% è: "Questo problema richiede intervento su database/server — contatta il tuo sviluppatore o hosting." Non perdi tempo cercando di fixare qualcosa che non puoi fixare da solo.

Domande frequenti

Il modulo Debug rallenta il sito?

No. La diagnostica viene eseguita su richiesta (quando clicchi "Analizza" nel pannello), non a ogni visita. L'health check è un cron giornaliero che gira di notte. Il conflict detector gira solo quando lo attivi esplicitamente. Zero impatto sulle performance per i visitatori, zero impatto sull'admin durante il lavoro quotidiano.

Posso usare Debug e Query Monitor insieme?

Sì, per scopi diversi. Il modulo Debug è per la diagnostica quotidiana (cosa è rotto?). Query Monitor è per l'analisi approfondita (perché è rotto? Quale query è lenta? Quale hook causa il problema?). Usa Debug come primo livello e Query Monitor come approfondimento quando serve l'analisi tecnica dettagliata.

Per continuare a leggere,
accedi al tuo account.

Il tuo account LANGA ti connette a tutta la Galaxy.