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

Nous avons rencontré notre lot d’erreurs WordPress – des écrans blancs, des pages manquantes et des conflits avec des extensions qui semblent sortir de nulle part.

Parfois, WordPress n’affiche pas par défaut ce qui ne va pas. Vous voyez juste une page blanche ou un message vague qui n’apporte pas beaucoup d’aide.

C’est là qu’intervient le mode débogage. Il vous permet de voir en coulisses ce qui est à l’origine du problème afin de le corriger plus rapidement.

Dans ce guide, nous vous montrerons comment activer le mode débogage de WordPress en toute sécurité – à l’aide d’un code ou d’une extension – et comment lire le journal des erreurs si quelque chose se connecte sur votre site.

Qu’est-ce que le mode débogage dans WordPress ?

Le mode débogage est un outil intégré à WordPress qui vous aide à voir ce qui se passe en coulisses lorsque quelque chose ne fonctionne pas sur votre site.

Par défaut, WordPress masque les messages d’erreur technique aux internautes et même à vous-même. Le mode débogage réactive ces messages afin que vous puissiez voir ce qui est à l’origine du problème.

C’est un peu comme allumer une lampe de poche dans une pièce sombre. Soudain, les erreurs qui étaient masquées deviennent visibles et vous pouvez repérer l’origine du problème.

Qu’il s’agisse d’un conflit avec un plugin, d’une erreur de codage ou d’un problème de thème, le mode débogage vous aide (ou aide votre développeur/développeuse) à obtenir les détails nécessaires pour corriger le problème.

Pourquoi activer le mode débogage de WordPress ?

Parfois, une extension WordPress, un thème ou un code personnalisé comme PHP ou JavaScript peut provoquer des conflits sur votre site.

Cela peut prospecter différentes erreurs et vous pouvez notifier que votre site ne fonctionne pas correctement.

Maintenant, vous pouvez toujours désactiver toutes les extensions pour voir laquelle est à l’origine de l’erreur. De même, vous pouvez passer à un thème WordPress différent ou retirer le code personnalisé pour trouver la cause première de l’erreur.

Cependant, tout cela prend beaucoup de temps, car vous devez exclure chaque possibilité une à une.

Heureusement, WordPress dispose d’un mode de débogage intégré. Cependant, il est inactif par défaut et vous devrez l’activer manuellement.

Une fois activé, le mode débogage affiche un journal des erreurs et des avertissements sur votre site.

De cette façon, vous pouvez mettre le doigt sur les problèmes de votre site WordPress et les corriger rapidement. Il découvre même des erreurs qui pourraient ne pas être visibles autrement.

Nous utilisons les outils de débogage intégrés à WordPress pour dépanner tous les sites. Souvent, ces outils fournissent des indices rapides qui nous aident à corriger facilement les problèmes rencontrés.

Voyons comment activer le mode débogage de WordPress. Nous allons vous afficher deux méthodes. Vous pouvez utiliser une extension WordPress ou afficher manuellement le mode débogage :

Méthode 1 : Activer le mode débogage de WordPress à l’aide d’une extension

Une façon simple d’activer le mode débogage est d’utiliser l’extension WP Debugging. Cette méthode est recommandée pour les débutants et ceux qui ne sont pas à l’aise avec les fichiers du site.

WP Debogage est une extension WordPress gratuite qui fonctionne dès sa sortie de l’emballage. En utilisant cette extension, vous n’aurez pas à modifier manuellement les fichiers de votre site.

Tout d’abord, vous devrez installer et activer l’extension WP Debogage. Pour plus de détails, veuillez consulter notre guide sur l ‘installation d’une extension WordPress.

Une fois activé, vous pouvez aller dans Outils ” Débogage WP à partir de votre Tableau de bord WordPress. Ensuite, assurez-vous que l’option ” Définir WP_DEBUG à true ” est activée.

Ensuite, vous verrez une option “Débogage Quick Look” ajoutée à votre barre d’administration en haut.

Survolez-la, puis cliquez sur l’option “Voir le fichier”.

Cela ouvrira le journal des erreurs sur votre site. Vous pouvez alors trouver ce qui cause des problèmes sur votre site et les corriger rapidement.

Lorsque vous avez terminé le débogage de votre site, n’oubliez pas de désactiver l’extension.

Méthode 2 : Activer manuellement le mode débogage de WordPress

La deuxième méthode pour activer le mode débogage de WordPress consiste à modifier les fichiers wp-config.php. Cette méthode est plus avancée et convient aux utilisateurs/utilisatrices qui sont à l’aise pour modifier les fichiers du site.

Nous vous recommandons de créer une sauvegarde de votre site avant de modifier les fichiers. Ainsi, vous pourrez facilement restaurer votre site en cas de problème.

Vous aurez besoin d’un client FTP pour Mac ou Windows pour accéder aux fichiers du site.

Pour ce tutoriel, nous utiliserons le client FTP FileZilla. Si vous avez besoin d’aide, veuillez consulter notre guide sur ce qu’est le FTP et comment l’utiliser.

Une fois que vous êtes connecté, rendez-vous dans le dossier public_html. C’est là que se trouve le fichier ‘wp-config.php’.

Par ailleurs, de nombreux hébergeurs WordPress vous permettent également de gérer les fichiers de votre site à l’aide du cPanel.

Par exemple, dans Bluehost, connectez-vous à votre compte d’hébergeur et cliquez sur le bouton “Réglages” sous votre site.

La page des Réglages de votre site s’ouvre alors.

Défilez un peu vers le bas et cliquez sur le bouton “Gestionnaire de fichiers”.

Cela lancera l’application Gestionnaire de fichiers dans un nouvel onglet du navigateur.

À partir de là, il suffit d’accéder au dossier public_html à partir du panneau situé à votre gauche.

Ensuite, défilez vers le bas jusqu’au fichier “wp-config.php”.

Ensuite, vous pouvez cliquer avec le bouton droit de la souris sur le fichier et le télécharger sur votre ordinateur. Il est conseillé de faire une copie de sauvegarde du fichier, au cas où quelque chose se passerait mal.

Ensuite, ouvrez le fichier à l’aide d’un logiciel ou d’un outil tel que Notepad ou Sublime Text.

Une fois le fichier ouvert, défilez vers le bas jusqu’à la ligne “C'est tout, arrêtez de modifier ! Bonne publication” et ajoutez le code suivant avant cette ligne :

define( 'WP_DEBUG', true);
define( 'WP_DEBUG_LOG', true); 

N’oubliez pas d’enregistrer le fichier avant de le fermer.

Ensuite, vous devez téléverser le fichier wp-config.php sur le serveur de votre site à l’aide du client FTP.

Pour plus de détails, veuillez consulter notre guide sur l’utilisation du FTP pour téléverser des fichiers sur WordPress.

Pour consulter les journaux d’erreurs de votre site, vous devez afficher les fichiers de votre site et naviguer jusqu’au chemin public_html/wp-content/debug.log. Il vous suffit de télécharger le fichier et de le voir à l’aide du logiciel Notepad/TextEdit pour constater les problèmes sur votre site.

Une fois que vous avez terminé le débogage de votre site, vous pouvez désactiver le mode débogage.

Pour désactiver le mode débogage dans WordPress, répétez ces étapes, puis retirez le code que vous avez ajouté au fichier wp-config.php ou modifiez le code suivant pour qu’il ait une valeur fausse :

define( 'WP_DEBUG', false);

🔧 Ressources Bonus : Approfondissez vos compétences en débogage WordPress

Maintenant que vous avez appris comment activer le mode débogage dans WordPress, vous pourriez être intéressé par l’amélioration de votre boîte à outils de dépannage. Voici quelques guides pour débutants qui vous aideront à résoudre les problèmes les plus courants et à optimiser les performances de votre site :

• Guide du débutant pour dépanner les erreurs de WordPress: Une approche étape par étape pour identifier et résoudre les problèmes courants de WordPress.
• Comment corriger l’erreur critique dans WordPress: Apprenez à remédier efficacement à l’une des erreurs les plus alarmantes de WordPress.
• Comment corriger l’écran blanc de WordPress: Découvrez des solutions pour récupérer votre site après un problème d’écran blanc.
• Les bases de l’élément Inspect : Outilde personnalisation de WordPress pour les utilisateurs/utilisatrices: Utiliser les outils du navigateur pour déboguer et personnaliser votre site sans affecter le contenu direct.
• Comment surveiller l’activité des utilisateurs sur WordPress avec les journaux d’audit de sécurité: Gardez une trace des modifications et des activités sur votre site pour identifier rapidement les problèmes potentiels.

Nous espérons que cet article vous a aidé à apprendre comment activer le mode débogage de WordPress pour corriger les erreurs du site. Vous pouvez également consulter nos guides sur la façon de corriger les erreurs courantes de WordPress ou d’ajouter des notifications d’administration personnalisées dans WordPress.

Si vous avez aimé cet article, veuillez alors vous abonner à notre chaîne YouTube pour obtenir des tutoriels vidéo sur WordPress. Vous pouvez également nous trouver sur Twitter et Facebook.