Comment exécuter le mode Debug dans WordPress

Même un site Web par­fai­te­ment géré et soig­neu­se­ment mis en place n’est pas à l’abri de l’une ou l’autre erreur. Des problèmes mineurs ou majeurs qui né­ces­si­tent une analyse et une ré­so­lu­tion aussi rapides et précises que possible peuvent survenir en par­ti­cu­lier lorsque dif­fé­rents plugins sont installés. C’est à ce stade que le mode Debug de WordPress in­ter­vient. Il vous permet de localiser ra­pi­de­ment les erreurs. Nous vous ex­pli­quons comment l’utiliser.

Certaines erreurs devraient être corrigées le plus vite possible : des petits défauts à la page blanche WordPress en passant par la page « Error es­ta­bli­shing a database con­nec­tion » WordPress. Le débogage WordPress évite de devoir vérifier chaque plugin in­di­vi­duel à cette fin. Une telle opération n’est pas seulement in­ter­mi­nable, mais ses résultats sont souvent in­fruc­tueux. Le mode Debug de WordPress est un outil précieux pour réaliser plus ef­fi­ca­ce­ment cette tâche. Une fois activé, les messages d’erreur s’affichent sur les pages con­cer­nées où vous pouvez commencer à résoudre le problème di­rec­te­ment à sa source.

Dans le même temps, vous pouvez également iden­ti­fier les pages qui fonc­tion­nent par­fai­te­ment et qui n’ont donc pas besoin de cor­rec­tions. WordPress Debug est donc un outil d’analyse important qui présente d’une part les endroits pro­blé­ma­tiques sur votre page et les zones qui sont conçues de manière optimale. Toutes les erreurs PHP et tous les aver­tis­se­ments sont affichés en haut de la page, même s’ils n'af­fec­tent pas (encore) les per­for­mances de votre site Web.

Une fois le problème résolu, il suffit de dé­sac­ti­ver le Debug WordPress. Cette étape est im­por­tante, car le texte de votre code PHP pourrait être exposé à vos visiteurs et pré­sen­te­rait donc un risque de sécurité possible. Le mode Debug de WordPress peut également nuire à la per­for­mance de votre site Web.

En plus du mode Debug normal de WordPress, le CMS propose également une option de jour­na­li­sa­tion. Quand vous utilisez WordPress Debug, vous pouvez certes observer toutes les erreurs sans délai, mais ceci ne donnera pas lieu à toute autre forme de do­cu­men­ta­tion. Dans le cas précis où des problèmes sur­vien­nent fré­quem­ment ou si vous souhaitez discuter des sources d’erreur avec un dé­ve­lop­peur externe par exemple, une do­cu­men­ta­tion précise peut s’avérer très ins­truc­tive et améliorer la capacité de ré­so­lu­tion des problèmes à l’avenir. Vous pouvez activer le journal de débogage WordPress sur votre serveur en réglant la constante « WP_DEBUG_LOG » sur « true ». WordPress consigne ensuite tous les messages d’erreur dans le fichier « wp-content/debug.log ». Vous pouvez toujours y consulter les messages, même ul­té­rieu­re­ment.

Plusieurs façons s’offrent à vous pour activer le débogage dans WordPress. Le moyen le plus direct est de passer par le fichier wp-config.php. Vous le trouverez dans le ré­per­toire principal de votre site Web. Connectez-vous à votre serveur via FTP pour modifier le fichier. Procédez comme suit à cet effet :

1. Pour plus de sécurité, créez toujours une sau­ve­garde de votre page WordPress.
2. Ouvrez le fichier wp-config.php dans votre éditeur.
3. Faites main­te­nant défiler l’écran vers le bas jusqu’à ce que vous trouviez la ligne « define('WP_DEBUG', false); ».
4. Vous pouvez main­te­nant la modifier par « define('WP_DEBUG', true); ».
5. Si cette ligne n’existe pas, il suffit de l’ajouter. L’endroit approprié pour cela est au-dessus du com­men­taire « /* That’s all, stop editing! Happy pu­bli­shing. */ ».
6. En­re­gis­trez ensuite vos mo­di­fi­ca­tions en haut de l’écran.

Vous avez activé le mode Debug dans WordPress au cours de cette étape. Une fois votre analyse terminée, quittez très sim­ple­ment le mode en annulant l’étape. Rouvrez donc le fichier, faites défiler jusqu’à la ligne men­tion­née ci-dessus et modifiez « true » en « false ». Le mode Debug de WordPress est terminé à l’issue de l’en­re­gis­tre­ment. Vous pouvez répéter la procédure aussi souvent que vous le souhaitez chaque fois que vous voulez re­cher­cher des erreurs sur votre site Web.

Comme mentionné ci-dessus, vous avez la pos­si­bi­lité de do­cu­men­ter l’analyse des erreurs de manière con­ve­nable. Vous exécutez de même cette étape dans le fichier wp-config.php. Pour ce faire, ajoutez une autre ligne sous la ligne « define('WP_DEBUG', true); » avec le contenu suivant : « define('WP_DEBUG_LOG', true); ». Les messages d’erreur sont en­re­gis­trés désormais dans un fichier journal et vous pouvez les analyser à tête reposée. La ligne sup­plé­men­taire « define('WP_DEBUG_DISPLAY', true); » ou « define('WP_DEBUG_DISPLAY', false); », que vous pouvez également placer en dessous, vous permet de spécifier si les messages de débogage WordPress doivent être présentés en utilisant HTML (true) ou non (false). Ces deux lignes ne sont toutefois pas obli­ga­toires pour le mode Debug de WordPress.

Vous avez également la pos­si­bi­lité de réaliser un débogage en faisant appel à un plugin WordPress. WP Debugging est une méthode très appréciée et gratuite. Après l’ins­tal­la­tion, le plugin active le mode Debug de WordPress et sau­ve­garde l’analyse dans un fichier journal. Si vous dé­sac­ti­vez ensuite le plugin, WordPress Debug sera également arrêté au­to­ma­ti­que­ment.

Le plugin Query Monitor est également dis­po­nible à titre d’al­ter­na­tive ou com­plé­men­taire. Ce plugin est également gratuit et convient pour le débogage WordPress des requêtes de base de données, des erreurs PHP ainsi que d’autres problèmes en relation avec des outils ou des plugins. Le plugin est assez complet et ré­per­to­rie une variété de sta­tis­tiques et d’in­for­ma­tions.

WordPress Debug est l’outil idéal pour une analyse efficace des erreurs de votre site Web. L’ac­ti­va­tion en soi est re­la­ti­ve­ment simple, et même si vous ne disposez pas de con­nais­sances ap­pro­fon­dies sur le sujet, vous pouvez au moins ra­pi­de­ment com­prendre où se situent les problèmes. Si vous ne voulez pas lancer le débogage WordPress en mode manuel, il existe des plugins re­com­man­dés et gratuits qui prennent en charge cette opération à votre place.