WordPress 5 min de lecture

Comment activer le journal de débogage WordPress

Par Golam Mostafa • Jul 25, 2021
Rédigé par un humain

Débug du WP est une variable globale permanente en PHP qui peut être utilisée pour activer le mode « debug » dans WordPress. Il est supposé que c'est faux par défaut, mais sur les copies de développement de WordPress, elle est généralement définie sur true dans le fichier wp-config.php.

Lorsqu'il est activé, le débogage WordPress enregistrera les erreurs détectées sur votre site. Cela peut être essentiel pour trouver la source d'un problème ou simplement pour en savoir plus sur les erreurs possibles sur votre site.

Dans ce blog, nous allons discuter de la façon d'activer WordPress pour déboguer les journaux via wp-config.php Modification du fichier.

Pourquoi avoir besoin d'activer le journal de débogage sur WordPress ?

Si vous pouvez afficher vos erreurs WordPress, vous devez activer les journaux de débogage. Si vous activez une option de journal de débogage, WordPress générera des journaux d'erreurs et affichera les détails des erreurs sur la page de vue de votre site Web.

Vous êtes un développeur WordPress et pouvez développer votre site WordPress, vous pouvez activer le mode de débogage pour détecter les erreurs.

Comment activer le mode de débogage à l'aide du fichier wp-config ?

Tout d'abord, ouvrez votre wp-config.php Fichier dans n'importe quel éditeur de texte pour modifier ce fichier et suivre certaines étapes.

Activer le débogage:

define( 'WP_DEBUG', true );

Désactiver le débogage:

define( 'WP_DEBUG', false );

Comment afficher les journaux d'erreurs sur le site WordPress ?

Le journal de débogage WP et l'affichage de Debug WP sont des constantes PHP qui étendent le débogage WP et peuvent également être utilisés pour déboguer WordPress.

Vous discuterez également, dans cette section, de la manière d'activer script_debug pour afficher les erreurs JavaScript.

wp_debug_log :

WP Debug Log est un plugin qui fonctionne avec WP Debug pour enregistrer toutes les erreurs dans un debug.log log fichier dans le /wp-content/ annuaire.

// Enable Debug logging to the /wp-content/debug.log file
define( 'WP_DEBUG_LOG', false );

Copiez et collez ce code à la suite de la capture d'écran.

Activer le journal de débogage :

define( 'WP_DEBUG_LOG', true );

-ou-

define( 'WP_DEBUG_LOG', '/tmp/wp-errors.log' );

faire attention si : pour WP_DEBUG_LOG faire quoi que ce soit, WP_DEBUG Doit être activé (vrai). Rappelez-vous, vous pouvez désactiver WP_DEBUG_DISPLAY indépendamment.

wp_debug_display :

WP Debug Display est un compagnon de WP Debug qui détermine si les messages de débogage sont affichés ou non dans le code HTML des pages.

La valeur par défaut est "Vrai", qui affiche les erreurs et les avertissements au fur et à mesure qu'ils se produisent. Si vous définissez ce paramètre sur False, toutes les erreurs seront masquées. Ceci doit être utilisé en conjonction avec Journal de débogage WP pour permettre une analyse ultérieure des défaillances.

// Disable display of errors and warnings
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Copiez et collez ce code à la suite de la capture d'écran pour afficher les erreurs WordPress.

Affichage du journal de débogage:

Vous pouvez ensuite retourner à votre site et ouvrir https://yoursitename.com/wp-content/debug.log

script_debug :

SCRIPT_DEBUG est une constante qui force WordPress à utiliser les versions « dev » des fichiers de base CSS et JavaScript plutôt que les versions minimisées qui sont normalement chargées. Ceci est utile lorsque vous testez des modifications de n'importe quel .js ou .css fichiers. La valeur par défaut est false.

// Use dev versions of core JS and CSS files (only needed if you are modifying these core files)
define( 'SCRIPT_DEBUG', true );

Conseils bonus :

Enregistrer les requêtes :

le SAVEQUERIES Definition enregistre les requêtes de base de données dans un tableau, et ce tableau peut être affiché pour aider à analyser ces requêtes. La constante définie comme true entraîne l'enregistrement de chaque requête, le temps que cette requête a mis à exécuter et la fonction qui l'a appelée.

define( 'SAVEQUERIES', true );

Erreurs, avertissements et avis PHP

habilitant WP_DEBUG entraînera l'affichage de toutes les erreurs, avis et avertissements PHP. Cela est susceptible de modifier le comportement par défaut de PHP, qui n'affiche que des erreurs fatales ou affiche un écran blanc de décès lorsque des erreurs sont atteintes.

L'affichage de tous les avis et avertissements PHP entraîne souvent des messages d'erreur pour les éléments qui ne semblent pas cassés, mais qui ne suivent pas les conventions de validation des données appropriées dans PHP. Ces avertissements sont faciles à corriger une fois le code pertinent identifié, et le code résultant est presque toujours plus résistant aux bogues et plus facile à entretenir.

Débogage PHP personnalisé

S'il est nécessaire de consigner des informations non-erreurs à des fins de débogage, PHP propose le error_log fonction à cet effet. Cependant, cette méthode ne fournit pas de sortie correctement formatée par défaut.

Pour résoudre ce problème, vous pouvez ajouter une autre fonction sur votre site pour gérer le formatage, soit en créant un plugin personnalisé, soit en utilisant un extrait avec des extraits de code. La fonction agira comme un emballage pour le error_log en servant print_r Pour formater correctement les tableaux et les objets avant de les enregistrer.

Voici un exemple de fonction qui nécessite WP_DEBUG à activer.

function write_log( $data ) { if ( true === WP_DEBUG ) { if ( is_array( $data ) || is_object( $data ) ) { error_log( print_r( $data, true ) ); } else { error_log( $data ); } }
}

Exemples d'utilisation :

write_log( 'DEBUG TEXT' );
write_log( $variable );

faire attention si : Il n'est pas recommandé d'ajouter du code personnalisé comme l'exemple ci-dessus dans functions.php Pour éviter la maintenance, la sécurité, les performances, la compatibilité et les problèmes d'organisation du code.

Vous pouvez nous contacter sur facebook et x. Consultez également notre Youtube Canal pour visionner des vidéos.

cleanly

Améliorez vos workflows WordPress avec ThemeDev

Découvrez des extensions, des guides et des outils conçus pour développer les activités WordPress.

Découvrir ThemeDev
Golam Mostafa
Rédigé par

Golam Mostafa

I'm a senior plugin developer for WordPress. I have four years of experience working as a software engineer for ADB Bank, and in 2018, I started developing plugins and founded ThemeDev.

Poursuivre la lecture

Voir tout
25+ meilleurs moteurs de recherche alternatifs à utiliser en 2026
SEO 28 min de lecture

25+ meilleurs moteurs de recherche alternatifs à utiliser en 2026

Google est le moteur de recherche le plus populaire, mais ce n'est pas le seul choix. De nombreux au...

Lire l’article complet
Mehrin Ferdous Mim
Mehrin Ferdous Mim Jan 30, 2025
WP Fastest Cache vs WP Super Cache vs Next3 Offload : lequel est le meilleur pour votre site Web ?
Next3 Offload 14 min de lecture

WP Fastest Cache vs WP Super Cache vs Next3 Offload : lequel est le meilleur pour votre site Web ?

Êtes-vous confus lors de la comparaison de WP Fastest Cache vs WP Super Cache vs Next3 Offload ?&n...

Lire l’article complet
Mehrin Ferdous Mim
Mehrin Ferdous Mim Apr 21, 2024
La collection ultime : les meilleurs plugins de sécurité WordPress
WordPress Plugins 18 min de lecture

La collection ultime : les meilleurs plugins de sécurité WordPress

Vous recherchez des plugins de sécurité WordPress ? Eh bien, vous êtes au bon endroit. Nous savo...

Lire l’article complet
Editorial Staff
Editorial Staff Dec 23, 2023

Recevez chaque semaine des conseils de croissance WordPress

Rejoignez les lecteurs de ThemeDev et recevez directement dans votre boîte mail des ressources pratiques sur WordPress, les extensions et la croissance de votre activité.