Que sont les journaux d'erreurs WordPress et comment les utilisez-vous ?

Publié: 2020-10-30

Si vous avez déjà rencontré un problème avec votre site Web WordPress que vous avez ensuite recherché sur Google, vous avez peut-être vu des articles d'assistance qui commencent par vous conseiller de "vérifier vos journaux WordPress". De même, si vous avez déjà demandé de l'aide à votre hébergeur WordPress, il aurait lui-même a) demandé une copie de vos journaux ou b) y aurait accédé de manière proactive afin de vous aider à résoudre votre problème. Alors, que sont exactement les journaux WordPress et comment les utiliseriez-vous pour résoudre les problèmes avec votre site Web WordPress ? Découvrons-le!

Que sont les journaux d'erreurs WordPress ?

Les journaux WordPress sont tout simplement un fichier qui enregistre les actions qui se sont produites sur votre site Web. Normalement, c'est le "Journal d'erreurs" qui est d'un intérêt primordial car c'est là que les détails de tous les problèmes survenus sur votre site sont enregistrés. Si votre site Web a été touché par le redoutable "écran blanc de la mort", par exemple, vous pouvez consulter vos journaux d'erreurs pour voir ce qui a été enregistré. Espérons que les données disponibles vous orienteront dans la direction de l'erreur et vous permettront ainsi de résoudre le problème. Il est clair que cela est d'une grande aide, car sans ces données, vous êtes un peu aveugle lorsqu'il s'agit de déterminer pourquoi quelque chose s'est mal passé sur votre site Web.

Comme le montre la capture d'écran d'un journal d'erreurs ci-dessus, une erreur a été enregistrée sur ce site Web particulier le 28 octobre et a été causée par un appel à une fonction indéfinie dans un thème. Le journal nous indique même quelle ligne de code a causé le problème, permettant à l'utilisateur du site Web ou à l'équipe technique d'hébergement de le résoudre.

Quels types de journaux WordPress existe-t-il ?

Il ne s'agit pas seulement des journaux d'erreurs (bien que cet article se concentre sur cet article car ce sont les fichiers journaux les plus couramment utilisés). Toute une gamme de logs est à votre disposition et les informations qui y sont contenues peuvent être utilisées pour faire un grand nombre de choses comme :

Localisez les erreurs sur votre site Web
Aide à la résolution de ces erreurs
Auditer l'accès à votre site Web
Surveillance des performances des plugins
Suivre l'activité des utilisateurs
Et beaucoup plus…

Une fois que vous vous serez habitué à accéder aux journaux et à les lire, vous constaterez qu'il deviendra une seconde nature de les vérifier et d'utiliser les informations qu'ils contiennent. Les journaux sont vraiment les héros méconnus de WordPress.

Activation des fichiers journaux de débogage WordPress

Comme nous l'avons maintenant constaté, les fichiers journaux (et en particulier les fichiers journaux d'erreurs) peuvent être des choses incroyablement utiles à utiliser. Bizarrement cependant, ces fichiers journaux sont en fait désactivés dans la plupart des nouvelles installations de WordPress. La raison? La journalisation de tout ce que fait votre site Web WordPress utilise une quantité importante de ressources serveur et, comme la plupart de ces informations ne sont pas nécessaires, il est logique de les désactiver et, ce faisant, d'améliorer les performances de votre site Web.

Si vous constatez que vous devez résoudre un problème sur votre site Web, vous devez d'abord activer ce que l'on appelle le "mode débogage". La manière standard de le faire est d'accéder à votre fichier wp-config.php .

Remarque : Avant d'entreprendre tout travail sur votre site Web, veuillez vous assurer que vous a) utilisez un serveur intermédiaire pour travailler sur votre site ou b) que vous avez effectué une sauvegarde appropriée de votre site Web.

Pour ce faire, connectez-vous à votre site via SFTP et dirigez-vous vers votre dossier /public_html/ . Dans ce dossier, vous verrez un fichier appelé wp-config.php .

Ouvrez-le à l'aide d'un éditeur de texte de votre choix, tel que Sublime, et faites défiler jusqu'à la ligne 76 environ. Vous devriez voir un commentaire et éventuellement une ligne de code indiquant define('WP_DEBUG', false); . La section complète du code, y compris les commentaires, ressemblera à ceci :

 /** For developers: WordPress debugging mode. Change this to true to enable the display of notices during development. It is strongly recommended that plugin and theme developers use WP_DEBUG in their development environments. */ define('WP_DEBUG', false);

Pour activer le mode de débogage de WordPress, vous devrez remplacer l'instruction false par true afin qu'elle lise define('WP_DEBUG', true); . Maintenant que le débogage est activé, nous devons dire à WordPress de générer le fichier journal lui-même. Pour ce faire, vous devrez ajouter une autre ligne qui lit define('WP_DEBUG_LOG', true); . Vous repartirez avec ceci :

 /** For developers: WordPress debugging mode. Change this to true to enable the display of notices during development. It is strongly recommended that plugin and theme developers use WP_DEBUG in their development environments. */ define('WP_DEBUG', true); define('WP_DEBUG_LOG', true);

Maintenant que le mode de débogage est activé et que les journaux sont générés, il ne nous reste plus qu'à les trouver !

Recherche de vos journaux d'erreurs

Votre tout nouveau fichier journal de débogage apparaîtra dans le dossier /wp-content/ et sera accessible via SFTP comme vous le feriez pour tout autre fichier de votre installation WordPress. Il est important de noter cependant que ce fichier apparaît UNIQUEMENT lorsqu'une erreur se produit. Si tout fonctionne parfaitement, ce fichier ne sera pas généré.

Donc, vous avez maintenant un jeu d'attente entre vos mains… si votre site Web est vraiment cassé, il ne faudra pas longtemps pour qu'une erreur se manifeste et le fichier journal sera généré. Si l'erreur est plus obscure et ne se produit que par intermittence, vous devrez simplement être patient et attendre que cela se produise.

Lorsqu'un fichier journal est généré, vous pouvez continuer et l'ouvrir avec votre éditeur de texte et commencer à lire. Le contenu pourrait bien être un peu écrasant mais, même si vous êtes débutant dans ce domaine, il existe normalement des indices clairs sur ce qui pourrait causer le problème. À ce stade, il s'agit alors de corriger le problème ou de le confier à un développeur ou à votre hébergeur (si c'est le type de problème que leur équipe d'assistance vous aidera).

IMPORTANT – Lorsque vous avez terminé le débogage de votre site, vous devez désactiver le mode débogage. Laisser cette option activée consommera inutilement les ressources du serveur et ralentira votre site Web.

Plugins de débogage

Il existe quelques plugins que vous aimeriez peut-être utiliser pour vous aider dans vos efforts de débogage recommandés par WordPress.

Barre de débogage

Debug Bar est le propre plugin de WordPress, vous pouvez donc être sûr qu'il fonctionnera bien avec votre site Web. Il ajoute un menu de débogage à la barre d'administration qui affiche la requête, le cache et d'autres informations de débogage utiles. Lorsque WP_DEBUG est activé, il suit également les avertissements et les avis PHP pour les rendre plus faciles à trouver. Il est décrit comme un "must" pour les développeurs !

Moniteur de requête

Query Monitor est décrit comme "le panneau d'outils de développement pour WordPress". Il permet le débogage des requêtes de base de données, des erreurs PHP, des hooks et des actions, des blocs d'éditeur de blocs, des scripts et des feuilles de style en file d'attente, des appels d'API HTTP, etc.

En plus de ce qui précède, il inclut certaines fonctionnalités avancées telles que le débogage des appels Ajax, les appels d'API REST et les vérifications des capacités de l'utilisateur. Il offre la possibilité de réduire une grande partie de sa sortie par plugin ou thème, vous permettant de déterminer rapidement les plugins, thèmes ou fonctions peu performants.

Journaux d'erreurs et débogage avec les sites Web hébergés par Pressidium

Si votre site Web est hébergé chez Pressidium, vous pouvez afficher les journaux d'accès et d'erreurs via le tableau de bord. Pour ce faire, connectez-vous à votre tableau de bord et dirigez-vous vers une installation de site Web, puis cliquez sur "Journaux". Gardez à l'esprit que vous ne verrez aucun journal d'erreur enregistré s'il n'y a eu aucune erreur sur votre site Web.

Si vous avez besoin de plus d'informations, vous pouvez activer le mode de débogage de WordPress sans avoir à modifier votre fichier wp-config.php . Dirigez-vous simplement vers le panneau des paramètres et basculez le commutateur WP_DEBUG. Gardez à l'esprit que les journaux de débogage peuvent contenir une énorme quantité d'informations, dont la plupart ne sont pas pertinentes pour la tâche à accomplir. En raison de la taille de ces journaux, vous pouvez remplir très rapidement l'espace disque, ce qui peut dégrader les performances de votre site Web. Pour cette raison, il est extrêmement important que vous désactiviez les journaux de débogage lorsque vous avez terminé le dépannage.

Conclusion

Les journaux d'erreurs de WordPress peuvent vous sauver la vie et vous aider à comprendre rapidement pourquoi quelque chose s'est mal passé sur votre site Web. Ils peuvent sembler un peu intimidants au début, mais une fois que vous vous serez habitué à y accéder et à les lire, vous apprécierez la richesse des informations qu'ils offrent. Bon débogage !