Il cuore di questa configurazione in WordPress risiede nel file wp-config.php, la centrale di controllo diagnostica del tuo sito. Attivare la modalità debug di WordPress è il primo passo cruciale. Questo si fa definendo la costante WP_DEBUG a true. È una pratica sconsigliata farlo direttamente su un sito in produzione senza estrema cautela, poiché potrebbe esporre informazioni sensibili agli utenti. Per un debug sicuro in produzione, è essenziale impostare WP_DEBUG_DISPLAY a false, impedendo la visualizzazione degli errori sul frontend, e contemporaneamente abilitare WP_DEBUG_LOG a true. Quest'ultima direttiva assicura che tutti gli errori e i warning vengano scritti in un file debug.log all'interno della directory wp-content, fornendo una traccia storica e dettagliata di ciò che sta accadendo "sotto il cofano". L'analisi di questo file debug.log è un'arte: saper leggere gli stack trace, identificare i tipi di errore come Notice, Warning o Fatal Error, e risalire alla riga esatta di codice problematica è la chiave per una diagnosi efficace. Per il debug del frontend, la costante SCRIPT_DEBUG impostata a true forza WordPress a caricare le versioni non minificate di JavaScript e CSS, rendendo molto più facile l'ispezione del codice nel browser. A volte, per problemi di performance legati al database, SAVEQUERIES può essere utile per registrare tutte le query SQL eseguite, anche se con un overhead significativo.

Non tutti gli errori vengono catturati da WP_DEBUG. Spesso, problemi più profondi o a livello di sistema si manifestano nei log degli errori a livello server. Questi log, che siano di PHP (php_error.log), Apache, o Nginx, contengono informazioni vitali su crash, esaurimento della memoria o problemi di configurazione del server. Accedere a questi log, sia tramite cPanel, SSH con comandi come tail -f o grep, o attraverso strumenti di gestione server, è un passo fondamentale. La correlazione dei timestamp e dei messaggi di errore tra i log del server e quelli di WordPress è un'abilità diagnostica che può risparmiare ore di lavoro. Un ulteriore strumento integrato in WordPress, la Salute del Sito (disponibile in Strumenti > Salute del sito), offre una panoramica rapida e intuitiva sullo stato di salute generale dell'installazione. Segnala versioni PHP obsolete, limiti di memoria insufficienti, moduli PHP mancanti, problemi di connessione al database e permessi di file, fornendo un punto di partenza per identificare problemi sistemici prima che diventino critici.

Il debugging avanzato in WordPress e WooCommerce richiede un approccio sistematico che combina strumenti tecnici, metodologie di analisi e una profonda comprensione dell'architettura di questi sistemi.

Configurazione dell'Ambiente di Debug

Impostazioni Base in wp-config.php

Le fondamenta del debugging WordPress iniziano con la corretta configurazione del file wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
define('SCRIPT_DEBUG', true);
define('SAVEQUERIES', true);

Questa configurazione:

  • Attiva la modalità debug
  • Scrive gli errori in wp-content/debug.log
  • Disabilita la visualizzazione a schermo (per sicurezza)
  • Carica versioni non minificate degli script
  • Registra tutte le query SQL eseguite

Per WooCommerce, è essenziale configurare livelli di log specifici:

define('WC_LOG_DIR', dirname(FILE) . '/wc-logs/');
add_filter('woocommerce_logging_level', function() { return 'debug'; });