WP_DEBUG_DISPLAY

Définition : WP_DEBUG_DISPLAY est une constante de configuration qui contrôle l’affichage des messages de débogage générés pendant l’exécution de WordPress. Elle s’utilise avec WP_DEBUG et doit être maîtrisée sur les sites publics.

Terminologie

Appellation / équivalent : WordPress Debug Display — affichage des erreurs de débogage

Autres appellations : Affichage des erreurs WordPress

Comprendre le fonctionnement

Lorsqu’un site fonctionne avec WP_DEBUG activé, la constante WP_DEBUG_DISPLAY indique si les messages de débogage peuvent apparaître dans les pages générées. Cette option est différente de WP_DEBUG_LOG, qui concerne leur enregistrement dans un journal. Le réglage n’est pas une solution de surveillance centralisée.

Une erreur affichée directement dans une réponse HTML peut révéler un chemin serveur, un nom de fichier ou un détail interne. Pour diagnostiquer un environnement de préproduction, WordPress recommande de combiner journalisation et désactivation de l’affichage. Le comportement final peut aussi dépendre des paramètres PHP et de l’hébergement.

Exemple concret

Un développeur analyse un avertissement dans un fichier de log tout en empêchant son affichage dans la page visitée.

Exemple de code commenté

<?php
// Exemple de configuration pour un environnement de test maîtrisé.
// À placer avant le chargement du Core dans wp-config.php.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );