Articles

WordPress.org

Langues : English – Français – Italiano – বাংলা – (Ajoutez votre langue)

WP_DEBUG est une constante PHP (une variable globale permanente) qui peut être utilisée pour déclencher le mode  » débogage  » dans tout WordPress. Elle est supposée être fausse par défaut et est généralement définie à true dans le fichier wp-config.php sur les copies de développement de WordPress.

Pour des informations sur les autres outils de débogage intégrés à WordPress, voir Debugging in WordPress

Usage

Activer le débogage.

define( 'WP_DEBUG', true );

Désactiver le débogage

define( 'WP_DEBUG', false );
NOTE : Les valeurs true et false dans l’exemple ne sont pas mises en apostrophes (‘) car ce sont des valeurs booléennes. Si vous définissez WP_DEBUG à ‘false’, cela sera interprété comme true parce que c’est une chaîne de caractères plutôt qu’un booléen.

WP_DEBUG_LOG et WP_DEBUG_DISPLAY

WP_DEBUG_LOG et WP_DEBUG_DISPLAY sont des constantes PHP supplémentaires qui étendent WP_DEBUG, et peuvent également être utilisées pour déboguer WordPress.

WP_DEBUG_LOG

WP_DEBUG_LOG est un compagnon de WP_DEBUG qui fait que toutes les erreurs sont également enregistrées dans un fichier journal debug.log à l’intérieur du répertoire /wp-content/. Ceci est utile si vous voulez revoir tous les avis plus tard ou si vous avez besoin de voir les avis générés hors écran (par exemple, pendant une requête AJAX ou une exécution de wp-cron).

define( 'WP_DEBUG_LOG', true );

WP_DEBUG_DISPLAY

WP_DEBUG_DISPLAY est un autre compagnon de WP_DEBUG qui contrôle si les messages de débogage sont affichés à l’intérieur du HTML des pages ou non. La valeur par défaut est ‘true’ qui affiche les erreurs et les avertissements tels qu’ils sont générés. En mettant cette option à false, toutes les erreurs seront cachées. Cela devrait être utilisé en conjonction avec WP_DEBUG_LOG afin que les erreurs puissent être examinées plus tard.

define( 'WP_DEBUG_DISPLAY', false );

Historique

L’option WP_DEBUG a été ajoutée dans la version 2.3.1 de WordPress.

À partir de la version 2.3.2 de WordPress, les erreurs de base de données sont imprimées uniquement si WP_DEBUG est défini sur true. Dans les versions précédentes, les erreurs de base de données étaient toujours imprimées. (Les erreurs de base de données sont gérées par la classe wpdb et ne sont pas affectées par les paramètres d’erreur de PHP.)

À partir de la version 2.5 de WordPress, la définition de WP_DEBUG à true élève également le niveau de rapport d’erreur à E_ALL et active les avertissements lorsque des fonctions ou des fichiers dépréciés sont utilisés ; sinon, WordPress définit le niveau de rapport d’erreur à E_ALL ^ E_NOTICE ^ E_USER_NOTICE.