Comment activer le mode débogage dans WordPress

L’activation du mode débogage nécessite de modifier un fichier de votre installation WordPress. C’est une opération simple, mais elle doit être effectuée avec soin afin d’éviter de casser le site. Ci-dessous, vous trouverez des instructions pas à pas pour le faire correctement.

Une fois activé, vous pourrez enregistrer les erreurs, les masquer aux visiteurs et contrôler la manière dont WordPress gère les informations de débogage. C’est particulièrement important sur les sites en production, où vous souhaitez que les erreurs soient consignées mais non visibles publiquement.

Localiser le fichier wp-config.php

La première étape pour activer le mode débogage consiste à localiser le fichier wp-config.php. Ce fichier se trouve dans le dossier racine de votre installation WordPress, au même emplacement que wp-content, wp-includes et wp-admin. Vous pouvez y accéder via un logiciel FTP, le gestionnaire de fichiers de votre hébergeur ou un accès local si vous travaillez sur un serveur de développement.

Il est recommandé de faire une copie de sauvegarde de ce fichier avant d’y apporter des modifications. Un seul caractère manquant peut casser votre site, et une sauvegarde vous permet de le restaurer immédiatement. Une fois le fichier trouvé, ouvrez-le avec un éditeur de texte et préparez-vous à modifier sa configuration.

Activer WP_DEBUG

À l’intérieur du fichier wp-config.php, faites défiler jusqu’à trouver une ligne ressemblant à ceci : define( 'WP_DEBUG', false );. Cette ligne contrôle si le mode débogage est actif ou non. Par défaut, WordPress désactive le débogage pour des raisons de sécurité et de performance. Pour l’activer, il suffit de remplacer la valeur false par true.

La ligne correcte doit ressembler à ceci : define( 'WP_DEBUG', true );. Après avoir enregistré le fichier, WordPress commencera immédiatement à afficher des avertissements, des notifications et des messages d’erreur PHP sur l’ensemble de votre site. Cela vous permettra d’identifier les extensions, thèmes ou morceaux de code problématiques.

Utiliser WP_DEBUG_LOG pour enregistrer les erreurs

Bien que l’affichage des erreurs à l’écran puisse être utile en phase de développement, ce n’est pas toujours pratique. Pour un suivi à long terme, vous pouvez activer WP_DEBUG_LOG. Pour cela, ajoutez la ligne suivante juste en dessous de la constante WP_DEBUG : define( 'WP_DEBUG_LOG', true );. Tous les erreurs seront alors enregistrées dans un fichier debug.log situé dans le répertoire wp-content.

Un fichier de log est particulièrement utile lorsque vous devez suivre des erreurs qui se produisent à des moments précis ou que vous ne pouvez pas reproduire directement à l’écran. Il vous permet également de partager le fichier avec des développeurs ou des équipes de support sans leur donner un accès direct à votre site.

Masquer les erreurs aux visiteurs

Si votre site WordPress est en ligne, vous ne souhaitez probablement pas que les visiteurs voient des messages d’erreur bruts. Dans ce cas, vous pouvez ajouter un autre paramètre pour désactiver l’affichage côté frontend : define( 'WP_DEBUG_DISPLAY', false );. Ainsi, les erreurs continueront à être enregistrées mais ne seront pas visibles pour les utilisateurs.

Vous pouvez également ajouter @ini_set( 'display_errors', 0 ); pour renforcer ce comportement. Cette combinaison permet de garder votre site professionnel et sécurisé, tout en offrant aux administrateurs et développeurs les informations nécessaires dans le fichier de débogage.

Débogage avancé avec SCRIPT_DEBUG

Pour les développeurs travaillant avec JavaScript et CSS, WordPress propose une constante supplémentaire : define( 'SCRIPT_DEBUG', true );. Par défaut, WordPress charge des versions minimisées des scripts et des styles. En activant le débogage des scripts, WordPress chargera les versions complètes et non minimisées, plus faciles à analyser et à corriger.

Ce réglage est particulièrement utile si vous développez des thèmes ou des extensions et que vous devez examiner le comportement des scripts et des styles. Il n’est généralement pas nécessaire pour les utilisateurs classiques, mais peut faire une grande différence pour les développeurs qui résolvent des problèmes côté frontend.

En résumé, activer le mode débogage de WordPress est une méthode simple mais puissante pour diagnostiquer et entretenir votre site web. En modifiant le fichier wp-config.php, vous pouvez afficher les erreurs, les enregistrer dans des logs et garder une présentation professionnelle même en cas de problème. Utilisé correctement, le mode débogage est l’un des outils les plus importants pour maintenir WordPress sécurisé, stable et adapté aux développeurs.