WP_DEBUG

Définition : WP_DEBUG est une constante de configuration WordPress qui active le mode de débogage. Elle aide à détecter des erreurs, avertissements et usages dépréciés pendant le développement, mais nécessite une gestion adaptée selon l’environnement.

Terminologie

Appellation / équivalent : WP_DEBUG — mode de débogage WordPress

Autres appellations : Débogage WordPress, WordPress debug

Comprendre le fonctionnement

La constante WP_DEBUG est généralement définie dans wp-config.php et vaut false sur une installation standard. Lorsqu’elle vaut true, WordPress adapte le signalement des erreurs et peut produire des avertissements utiles à l’analyse de problèmes.

Elle interagit avec WP_DEBUG_LOG, qui peut enregistrer les messages, et WP_DEBUG_DISPLAY, qui contrôle leur affichage dans la réponse HTML. Sur un site public, un affichage intempestif peut exposer des chemins ou détails internes : le mode doit être maîtrisé.

Exemple concret

Sur un environnement de développement, activer le débogage aide à identifier l’utilisation d’une fonction dépréciée pendant la mise à jour d’une extension.

Exemple de code commenté

<?php
// Exemple pour une installation de développement uniquement.
// À placer avant le chargement du Core dans wp-config.php.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_DISPLAY', false );