Débogage WordPress et tout ce que vous devez savoir

25 novembre 2020

Parfois, nous sommes incapables de reproduire un problème rencontré par un utilisateur lors de l'utilisation de l'un de nos plugins WordPress. Lorsque cela se produit, nous demandons à l'utilisateur de nous envoyer plus d'informations sur la configuration de son site Web et de son plugin.

Ces informations se trouvent généralement dans un fichier journal, plus précisément, le fichier journal de débogage WordPress. Ce fichier journal peut être généré en activant le mode de débogage WordPress. Dans cet article, nous allons explorer le mode de débogage WordPress intégré et vous montrer comment l'activer. Ensuite, nous partagerons également quelques options de débogage WordPress supplémentaires.

Voici ce que nous allons couvrir:

  • Introduction au mode de débogage de WordPress
  • Comment activer le mode de débogage WordPress
  • Options de débogage WordPress supplémentaires
  • Le mode de débogage de WordPress affecte-t-il les performances de votre site Web

Quel est le but du débogage WordPress?

En cas de problèmes présents sur votre site Web, le mode de débogage de WordPress peut vous aider à découvrir ce qui ne va pas sur votre site Web. Il le fait en signalant toutes les erreurs, avertissements et avis. Tous ces éléments sont affichés dans l'interface utilisateur et peuvent également être redirigés vers un fichier journal.

Notez que le débogage est désactivé par défaut sur WordPress et qu'il ne doit être activé que temporairement pour résoudre les problèmes. Le débogage WordPress ne doit pas être activé de manière permanente sur les sites Web en direct, car il affectera les performances du plugin et révélera éventuellement des informations sensibles sur le site Web qui peuvent être utilisées de manière malveillante.

Erreur de débogage WordPress

Activation du débogage WordPress

Pour activer le mode de débogage WordPress et le fichier journal de débogage, suivez la procédure ci-dessous:

  1. Activez le débogage WordPress en définissant le commutateur WP_DEBUG dans le fichier wp-config.php sur true, comme dans l'exemple suivant: define ('WP_DEBUG', vrai);
  2. Activez le fichier journal de débogage en ajoutant la ligne suivante au fichier wp-config.php: define ('WP_DEBUG_LOG', vrai);

Le fichier journal de débogage WordPress est appelé debug.log et il est créé dans le / wp-content / Sous-répertoire WordPress.

Une fois que vous avez activé le débogage, reproduisez le problème afin que l'erreur soit capturée dans le fichier journal. Après avoir reproduit le problème, désactivez le débogage en définissant les directives WP_DEBUG et WP_DEBUG_LOG dans le fichier wp-config.php sur false, comme indiqué ci-dessous:

define ('WP_DEBUG', faux);

define ('WP_DEBUG_LOG', faux);

Options de débogage WordPress supplémentaires

Très probablement, nous ne vous demanderons jamais d'utiliser ces options, mais il est également bon de les connaître. Outre les méthodes de débogage mentionnées ci-dessus, vous pouvez également utiliser les méthodes de débogage WordPress suivantes:

WP_DEBUG_DISPLAY

Lorsque cette option est activée avec le commutateur de débogage de WordPress, WordPress affiche les messages de débogage dans les pages HTML au fur et à mesure de leur génération.

Notez que si cela est utilisé sur un site Web en direct, cela peut entraîner la divulgation d'informations sensibles sur le site Web et la configuration du serveur. Pour activer cette option, ajoutez la ligne ci-dessous à votre fichier wp-config.php:

define ('WP_DEBUG_DISPLAY', vrai);

SCRIPT_DEBUG

Lorsque cette option et le débogage WordPress sont activés, WordPress utilise les versions de développement des fichiers CSS et JavaScript de base au lieu de la version réduite (compressée) qu'il utilise normalement.

Cette option de débogage est utile si vous testez des modifications dans les fichiers .js et .css. Pour activer cette option, ajoutez la ligne ci-dessous à votre fichier wp-config.php:

define ('SCRIPT_DEBUG', vrai);

Journalisation des requêtes de base de données WordPress

Sur WordPress, vous pouvez également conserver un journal de la requête de base de données WordPress dans un tableau. Cette option est pratique si vous rencontrez des problèmes de base de données WordPress ou si vous souhaitez vérifier quelles requêtes sont envoyées.

Pour l'activer, ajoutez la ligne suivante à votre fichier WordPress wp-config.php:

define ('SAVEQUERIES', vrai);

Une fois que vous activez cette option, toutes les requêtes seront enregistrées dans les requêtes $ wpdb-> globales.

Le débogage affecte-t-il les performances de mon site Web WordPress?

Oui. Certaines options de débogage peuvent avoir un impact sur les performances de votre site Web. Par conséquent, à moins qu'il ne s'agisse d'un site Web de test ou de préparation, ou que vous ne soyez invité à activer temporairement le débogage par les développeurs, n'activez pas le débogage sur les sites Web en direct.