Le mode débogage de WordPress rend visibles les erreurs, avertissements et notifications cachés qui sont normalement ignorés silencieusement. Vous l’activez en ajoutant trois lignes à wp-config.php, après quoi les erreurs sont écrites dans un fichier journal. Vous pouvez ainsi rapidement repérer les conflits de plugins, les problèmes de thème et les erreurs PHP, sans que les visiteurs ne s’en aperçoivent.
Qu’est-ce que le mode débogage de WordPress ?
Le mode débogage est une fonctionnalité intégrée de WordPress qui capture les erreurs PHP, les avertissements et les notices, et les rend visibles ou enregistrables. Par défaut, ce mode est désactivé, afin que les visiteurs ne voient jamais de messages d’erreur sur votre site. En tant qu’administrateur ou développeur, vous souhaitez justement voir ces messages, par exemple lors du test d’un nouveau thème, de l’installation de plugins ou de la recherche de la cause d’une page blanche (le fameux « white screen of death »).
Avec le mode débogage, vous pouvez :
- Repérer les erreurs et avertissements PHP
- Mettre en évidence les conflits entre plugins et thèmes
- Signaler les fonctions obsolètes (deprecated)
- Analyser les requêtes de base de données et les erreurs de script
Activer le mode débogage via wp-config.php
Le fichier wp-config.php contient les paramètres de base de votre installation WordPress et se trouve à la racine de votre site. Vous pouvez le modifier via FTP ou via le gestionnaire de fichiers dans Plesk.
Connectez-vous à votre compte d’hébergement
Connectez-vous via FTP ou ouvrez le gestionnaire de fichiers dans Plesk et naviguez jusqu’au dossier racine de votre site WordPress (généralement public_html ou le dossier de votre nom de domaine).
Ouvrez wp-config.php
Recherchez le fichier dans le répertoire racine et ouvrez-le dans un éditeur de texte. Faites d’abord une copie du fichier par sécurité.
Ajoutez les constantes de débogage
Recherchez la ligne / That's all, stop editing! / et ajoutez au-dessus :
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
Enregistrez et vérifiez
Enregistrez le fichier et visitez votre site. Les erreurs ne s’affichent plus à l’écran, mais sont désormais écrites dans wp-content/debug.log.
WP_DEBUG_DISPLAY sur true que lors des tests sur un environnement de développement séparé, jamais sur votre site en production.Utiliser le fichier journal de débogage
Dès que WP_DEBUG_LOG est activé, WordPress enregistre chaque erreur dans wp-content/debug.log. Ce fichier contient des horodatages, des messages d’erreur et le nom du fichier où l’erreur se produit, ce qui indique précisément où chercher.
Vous ouvrez le fichier journal via le gestionnaire de fichiers dans Plesk ou via FTP avec un éditeur de texte. Sur les sites volumineux, ce fichier peut rapidement grossir, vérifiez-le donc régulièrement et supprimez-le ou archivez-le une fois le débogage terminé, afin qu’il n’occupe pas inutilement de l’espace disque.
Si vous repérez dans le fichier journal un message concernant un plugin ou un fichier de thème spécifique, vous savez immédiatement où se situe le problème. Vous pouvez alors mettre à jour, désactiver ce plugin ou modifier le code concerné de manière ciblée.
Déboguer en toute sécurité sur un site en production
Activer le mode débogage sur un site de production comporte des risques si les erreurs deviennent visibles pour les visiteurs : cela peut révéler des informations sensibles sur le chemin de votre serveur ou votre configuration. Conservez donc toujours cette combinaison sur un site en production :
WP_DEBUGsur true afin que les erreurs soient capturéesWP_DEBUG_LOGsur true afin qu’elles soient enregistréesWP_DEBUG_DISPLAYsur false afin qu’elles n’apparaissent jamais à l’écran
Si vous préférez travailler sur un environnement de test séparé, c’est l’option la plus sûre : appliquez-y les modifications, testez-les minutieusement et désactivez ensuite le mode débogage avant de passer en production. N’oubliez pas non plus de supprimer les lignes après le débogage ou de les repasser sur false, afin que votre site n’enregistre pas de journal inutilement.
Si vous rencontrez des erreurs persistantes qui ne sont pas expliquées dans le fichier journal, consultez également les paramètres de votre environnement d’hébergement web ou consultez la base de connaissances pour plus d’informations.
Questions fréquentes
Puis-je activer le mode débogage sur mon site en production ?
Oui, à condition de mettre WP_DEBUG_DISPLAY sur false. Les erreurs seront alors uniquement enregistrées, et non affichées aux visiteurs.
Où trouver le fichier debug.log ?
Dans le dossier wp-content/debug.log, accessible via FTP ou le gestionnaire de fichiers dans Plesk.
Comment désactiver à nouveau le mode débogage ?
Mettez WP_DEBUG sur false ou supprimez complètement les trois lignes de débogage de wp-config.php.
Le mode débogage a-t-il un impact sur la vitesse de mon site ?
La journalisation coûte un peu de temps de traitement supplémentaire, mais c’est négligeable sur les environnements de test. Désactivez-le donc sur votre site en production une fois terminé.
Je ne vois pas de fichier debug.log, que faire ?
Vérifiez que le dossier wp-content dispose des droits d’écriture et que les trois lignes ont été ajoutées correctement et sans fautes de frappe dans wp-config.php.
Conclusion
Vous activez le mode débogage de WordPress en ajoutant trois lignes à wp-config.php. Vous enregistrez ainsi les erreurs dans un fichier journal sans les rendre visibles pour les visiteurs. Vérifiez régulièrement le fichier journal, désactivez le mode débogage après utilisation et travaillez de préférence sur un environnement de test pour les modifications importantes.