Comment activer le mode de débogage WordPress pour corriger les erreurs

Comment activer le mode débogage dans WordPress ou obtenir plus d'informations sur les erreurs WordPress affichées sur un navigateur Web ? Si vous êtes un utilisateur ou un développeur WordPress et que vous posez ces questions, vous êtes tombé sur la bonne ressource. Ce guide vous montrera comment activer les fonctionnalités de débogage de WordPress.

WordPress fournit plusieurs outils de débogage puissants tant pour les développeurs que pour les non-programmeurs ou les utilisateurs généraux, que vous pouvez activer à l'aide des options de configuration disponibles. Ces options, une fois activées, vous aident à trouver et à résoudre rapidement les erreurs en affichant les informations détaillées sur l'erreur.

Nous allons démontrer en utilisant l'erreur suivante que nous avons rencontrée lors de la configuration d'un site factice à des fins de test.

Lorsque vous regardez cette erreur, il n’y a pas beaucoup d’informations qui l’accompagnent. Cela peut avoir plusieurs causes : le serveur de base de données peut être en panne ou les paramètres de connexion à la base de données (c'est-à-dire le nom de la base de données, l'utilisateur de la base de données et le mot de passe de l'utilisateur) définis dans le fichier de configuration wp-config.php peuvent se tromper.

Alors, comment pouvons-nous obtenir plus d’informations sur l’erreur ci-dessus ? L'option WP_DEBUG est une variable globale permanente PHP qui active le mode « debug » dans WordPress, provoquant ainsi l'affichage de toutes les erreurs, notifications et avertissements PHP sur le navigateur.

Cette fonctionnalité « debug » a été ajoutée dans la version 2.3.1 de WordPress et est configurée dans wp-config.php – l'un des fichiers les plus importants. dans votre installation WordPress.

Par défaut, la fonctionnalité « debug » est définie sur false dans toute installation WordPress. Pour activer WP_DEBUG, définissez-le sur true.

Tout d'abord, accédez au répertoire d'installation de votre site Web, par exemple /var/www/html/mysite.com, puis ouvrez le fichier wp-config.php à l'aide de votre éditeur de texte préféré.

cd /var/www/html/mysite.com
sudo vim wp-config.php

Recherchez cette ligne.

define( 'WP_DEBUG',  false );

et change-le en

define( 'WP_DEBUG', true );

Enregistrez le fichier et fermez-le.

Le mode débogage a maintenant été déclenché. Si nous rechargeons la page qui a montré l'erreur, nous pouvons voir les informations détaillées sur l'erreur, comme indiqué dans la capture d'écran suivante.

Il existe des options de debug supplémentaires qui étendent WP_DEBUG et qui sont particulièrement utiles pour les développeurs WordPress créant des plugins ou des thèmes, ou tout autre composant. Il s'agit de WP_DEBUG_LOG et WP_DEBUG_DISPLAY.

L'option WP_DEBUG_LOG, lorsqu'elle est définie sur true, entraîne l'enregistrement de toutes les erreurs dans un fichier journal debug.log dans le fichier /wp-content. //répertoire par défaut. Ceci est utile pour une analyse ou un traitement ultérieur.

define( 'WP_DEBUG_LOG', true );

Mais vous pouvez spécifier un fichier journal personnalisé, par exemple /var/log/nginx/mysite.com_wp-errors.log :

define( 'WP_DEBUG_LOG', '/var/log/nginx/mysite.com_wp-errors.log' );

Et WP_DEBUG_DISPLAY contrôle si les messages de débogage sont affichés ou non dans le code HTML des pages. Par défaut, il est défini sur true. Pour le désactiver, définissez-le sur false.

define( 'WP_DEBUG_DISPLAY', false );

Activer le mode débogage dans WordPress à l'aide du plugin

Si vous utilisez un hébergement mutualisé, vous n'avez probablement pas accès au backend du serveur pour modifier vos fichiers WordPress, dans ce cas le fichier wp-config.php.

Ou si vous préférez simplement modifier les paramètres depuis le tableau de bord d'administration, vous pouvez installer et utiliser un plugin appelé « Debug Bar » qui vous permet d'activer/désactiver facilement WP_DEBUG depuis le tableau de bord d'administration d'un simple clic sur l'icône. Barre d'outils.

La fonctionnalité phare de ce plugin est qu'il est sûr et intelligent, il quitte automatiquement le mode WP_DEBUG en cas d'erreurs.

Référence : Débogage dans WordPress.