Débugger WordPress comme un Pro : Guide Pratique 🔍 -

Résumez cet article avec votre IA préférée

Salut jeune padawan ! Tu galères avec un bug WordPress qui te donne des sueurs froides ? Pas de panique, je vais te montrer comment devenir un véritable Sherlock Holmes du debugging WordPress !

🎯 Première étape : Configurer ton labo de debug

Commence par transformer ton wp-config.php en véritable centre de commandement :

// Active le mode détective 🕵️‍
define('WP_DEBUG', true);

// Note tout dans un fichier
define('WP_DEBUG_LOG', true);

// Affiche à l'écran (à éviter en prod !)
define('WP_DEBUG_DISPLAY', true);

// Désactive le min des scripts
define('SCRIPT_DEBUG', true);

🔍 Les outils indispensables de l’enquêteur

1. Query Monitor – Ton meilleur allié

C’est comme avoir une caméra de surveillance sur ton WordPress. Il te montre :

Les requêtes SQL suspectes
Les hooks qui traînent
Les templates chargés
Les temps de chargement

2. Le journal de bord personnalisé

function super_debug($message, $data = null) {
    if ( defined( 'WP_DEBUG' ) && WP_DEBUG ) {
        $trace = debug_backtrace()[0];
        $log_entry = sprintf(
            "[%s] %s:%d - %s",
            date('Y-m-d H:i:s'),
            basename($trace['file']),
            $trace['line'],
            $message
        );
        
        if ($data) {
            $log_entry .= "\n" . print_r($data, true);
        }
        
        error_log($log_entry . "\n", 3, WP_CONTENT_DIR . '/debug.log');
    }
}

// Utilisation
super_debug("L'utilisateur fait des bêtises", $_POST);

Pense à regarder la doc error_log 👽

🕵️‍♂️ Techniques d’investigation avancées

1. Espionner les hooks WordPress

function hook_detective($hook_name) {
    add_action($hook_name, function() use ($hook_name) {
        super_debug("🎣 Hook déclenché : " . $hook_name, [
            'args' => func_get_args(),
            'time' => microtime(true)
        ]);
    }, 0);
}

// Surveillance des suspects habituels
hook_detective('init');
hook_detective('wp_loaded');
hook_detective('wp_footer');

Pour debug les filtres, c’est une autre histoire … Tu peux tenter

add_action(
	'shutdown',
	function () {
        if ( ! defined( 'WP_DEBUG' ) || ! WP_DEBUG ) {
            return;
        }

		global $wp_actions, $wp_filter;

		echo '<pre>' . print_r( $wp_filter, true ) . '</pre>';
		die();
	},
	999
);

Si tu essaies de tout logger d’un coup, tu risques de te prendre un beau « Fatal error: Allowed memory size » dans la figure (Cette structure est beaucoup plus complexe et volumineuse). L’idéal c’est de boucler dessus $wp_filter et de print + die juste ce que tu as besoin.

En comparaison : $wp_actions est ton ami ! C’est une structure simple qui contient juste les noms des hooks et leur nombre d’exécutions. Tu peux le débugger sans crainte.

2. Traquer les requêtes SQL louches

/**
 * Debug les requêtes SQL lentes sans impacter les performances
 * Utilise SAVEQUERIES et un seuil de temps configurable
 */
function better_db_detective() {
	// Vérifie si on est en mode debug et si SAVEQUERIES est activé
    if ( ! defined( 'WP_DEBUG' ) || ! WP_DEBUG ) {
      return;
    }
  	if ( ! defined( 'SAVEQUERIES' ) || ! SAVEQUERIES ) {
		return;
	}

	// On attend la fin de l'exécution pour analyser
	add_action(
		'shutdown',
		function () {
			global $wpdb;

			// Seuil de temps en secondes (ici 1 seconde)
			$threshold = 1;

			// Analyse uniquement si $wpdb->queries existe
			if ( ! empty( $wpdb->queries ) ) {
				foreach ( $wpdb->queries as $query ) {
					// $query[1] contient le temps d'exécution
					if ( $query[1] > $threshold ) {
						super_debug(
							sprintf(
								"[Requête lente] Temps: %fs\nRequête: %s\nCaller: %s\n",
								$query[1],
								$query[0],
								$query[2]
							)
						);
					}
				}
			}
		},
		999
	);
}

🎯 Les scènes de crime courantes

1. Le mystère du template disparu

/**
 * Log les fichiers PHP inclus dans WordPress, groupés par catégorie
 */
function log_included_files() {
	if ( ! defined( 'WP_DEBUG' ) || ! WP_DEBUG ) {
		return;
	}

	$files = array(
		'wp-admin'    => array(),
		'wp-includes' => array(),
		'wp-content'  => array(
			'themes'  => array(),
			'plugins' => array(),
			'other'   => array(),
		),
		'root'        => array(),
	);

	foreach ( get_included_files() as $file ) {
		$path = str_replace( ABSPATH, '', $file );
		if ( strpos( $path, 'wp-admin/' ) === 0 ) {
			$files['wp-admin'][] = $path;
		} elseif ( strpos( $path, 'wp-includes/' ) === 0 ) {
			$files['wp-includes'][] = $path;
		} elseif ( strpos( $path, 'wp-content/' ) === 0 ) {
			if ( strpos( $path, 'wp-content/themes/' ) === 0 ) {
				$files['wp-content']['themes'][] = $path;
			} elseif ( strpos( $path, 'wp-content/plugins/' ) === 0 ) {
				$files['wp-content']['plugins'][] = $path;
			} else {
				$files['wp-content']['other'][] = $path;
			}
		} else {
			$files['root'][] = $path;
		}
	}
	super_debug( 'WordPress Files Loaded', $files );
}
add_action( 'shutdown', 'log_included_files', 999 );

2. L’énigme des assets manquants

function assets_detective() {
	global $wp_scripts, $wp_styles;
	super_debug(
		'📚 Assets chargés',
		array(
			'scripts' => array_keys( $wp_scripts->registered ),
			'styles'  => array_keys( $wp_styles->registered ),
		)
	);
}
add_action( 'wp_print_scripts', 'assets_detective', 999 );

❓Priorité 999

C’est tout con, un priorité basse pour arriver en dernier. On attend que tout s’éxécute pour intervenir ensuite.

⚠️ Hey Padawan, la priorité basse c’est comme les roues stabilisatrices : parfait pour débugger, mais danger en prod ! Remets des priorités classiques et surtout, protège ce code avec des constantes de debug – parce qu’un ninja ne laisse pas traîner ses outils d’entraînement en mission ! 🥷

📝 La checklist du parfait détective

✅ Activer WP_DEBUG
✅ Installer Query Monitor
✅ Vérifier le fichier debug.log
✅ Désactiver les plugins un par un
✅ Passer temporairement sur un thème par défaut
✅ Vérifier les conflits de versions PHP/WordPress

🎓 Pro Tips

Garde toujours une copie des fichiers ou de la base avant de jouer au détective
Les erreurs 500 se cachent souvent dans les .htaccess
Un wp_mail() qui ne marche pas ? Installe un plugin SMTP pour débugger
Les problèmes de performance ? Active Query Monitor et SAVEQUERIES

🚀 Pour aller plus loin

Apprends à utiliser xDebug avec WordPress
Explore le débogueur de navigateur pour les problèmes JavaScript
Mets en place un environnement de développement local avec MailHog

💡 Le mot de la fin

Le debugging WordPress, c’est comme une enquête policière : patience, méthode et un bon outillage font toute la différence.

N’oublie pas que même les meilleurs détectives demandent parfois de l’aide !

Débugger WordPress comme un Pro : Guide Pratique 🔍