Comment activer le mode débogage dans WordPress ?

Le mode débogage, également appelé mode debug, est une fonctionnalité intégrée à WordPress qui vous permet d’identifier et de résoudre les problèmes de votre site en affichant des informations détaillées sur les erreurs et les avertissements. Lorsque le mode débogage est activé, WordPress affiche des messages d’erreur directement sur votre site, ce qui peut vous aider à comprendre la cause d’un problème comme le white screen of death.

Afficher les erreurs à l’écran

Voici comment activer le mode débogage dans WordPress :

1. Connectez-vous à votre site via FTP ou à l’aide d’un gestionnaire de fichiers dans le panneau de contrôle de votre hébergeur.
2. Accédez au dossier racine de votre site WordPress, où se trouvent les fichiers principaux de WordPress.
3. Recherchez et ouvrez le fichier wp-config.php dans un éditeur de texte.
4. Trouvez la ligne suivante : define('WP_DEBUG', false);.
5. Modifiez cette ligne pour qu’elle devienne : define('WP_DEBUG', true);.
6. Enregistrez vos modifications et fermez le fichier.
7. Transférez le fichier modifié sur votre serveur, en écrasant l’ancien fichier wp-config.php.

Une fois le mode débogage activé, rechargez votre site pour voir si des messages d’erreur apparaissent. Ces messages peuvent vous aider à identifier la cause du problème et à prendre les mesures appropriées pour le résoudre. N’oubliez pas de désactiver le mode débogage une fois que vous avez résolu le problème, car laisser des messages d’erreur visibles sur votre site peut présenter des risques de sécurité. Pour ce faire, modifiez à nouveau le fichier wp-config.php, en remplaçant true par false dans la ligne define('WP_DEBUG', true);.

Si vous préférez afficher les erreurs dans un fichier

Pour activer le mode débogage sans afficher les erreurs à l’écran et les enregistrer dans un fichier à la place, vous devez modifier légèrement la configuration de WordPress. Voici comment procéder :

1. Connectez-vous à votre site via FTP ou à l’aide d’un gestionnaire de fichiers dans le panneau de contrôle de votre hébergeur.
2. Accédez au dossier racine de votre site WordPress, où se trouvent les fichiers principaux de WordPress.
3. Recherchez et ouvrez le fichier wp-config.php dans un éditeur de texte.
4. Trouvez la ligne suivante : define('WP_DEBUG', false);.
5. Modifiez cette ligne pour qu’elle devienne : define('WP_DEBUG', true);.
6. Ajoutez les lignes suivantes immédiatement après la ligne que vous venez de modifier :

Ces lignes de code signifient que les erreurs seront enregistrées dans un fichier de journal (log) au lieu d’être affichées à l’écran, et que l’affichage des erreurs PHP sera désactivé.

7. Enregistrez vos modifications et fermez le fichier.
8. Transférez le fichier modifié sur votre serveur, en écrasant l’ancien fichier wp-config.php.

Une fois cette configuration appliquée, les messages d’erreur ne seront plus affichés à l’écran, mais ils seront enregistrés dans un fichier nommé debug.log situé dans le dossier wp-content de votre installation WordPress. Vous pouvez consulter ce fichier pour identifier et résoudre les problèmes de votre site sans que les erreurs soient visibles pour les visiteurs.

N’oubliez pas de désactiver le mode débogage une fois que vous avez résolu le problème. Pour ce faire, modifiez à nouveau le fichier wp-config.php, en remplaçant true par false dans la ligne define('WP_DEBUG', true);, et supprimez ou commentez les lignes que vous avez ajoutées précédemment.

Le mode débogage dans WordPress est un outil puissant pour résoudre les problèmes sur votre site. En activant cette fonctionnalité de manière appropriée, vous pourrez identifier les erreurs et les avertissements qui pourraient affecter le bon fonctionnement de votre site. Cependant, n’oubliez pas de désactiver le mode débogage une fois que vous avez terminé vos corrections afin de maintenir la sécurité de votre site. Suivez ces étapes avec prudence et profitez de l’efficacité du mode débogage pour améliorer votre expérience WordPress.