Introduction au Debug WordPress

Debug WordPress est un outil essentiel pour tout administrateur de site cherchant à diagnostiquer et corriger les erreurs. Lorsque votre site affiche une page blanche ou que des plugins ne fonctionnent pas correctement, le mode debug peut vous aider à identifier les problèmes sous-jacents. Dans cet article, nous allons explorer les différentes méthodes pour activer le debug, les constantes à utiliser dans le fichier wp-config.php, ainsi que des outils complémentaires comme Query Monitor.

Pourquoi activer le Debug WordPress ?

Le mode debug de WordPress révèle les erreurs PHP qui peuvent être cachées derrière des pages blanches ou des fonctionnalités défaillantes. Par défaut, WordPress désactive l’affichage des erreurs pour des raisons de sécurité, ce qui peut rendre le diagnostic difficile. En activant le debug, vous pouvez voir toutes les erreurs et avertissements qui se produisent sur votre site.

Les constantes de debug dans wp-config.php

Pour activer le mode debug, vous devez modifier le fichier wp-config.php à la racine de votre installation WordPress. Voici les quatre constantes essentielles :

  • WP_DEBUG : C’est l’interrupteur principal. Mettez-le à true pour afficher toutes les erreurs.
  • WP_DEBUG_LOG : Enregistre les erreurs dans un fichier /wp-content/debug.log au lieu de les afficher sur le site.
  • WP_DEBUG_DISPLAY : Contrôle l’affichage des erreurs sur le site. En production, mettez-le à false.
  • SCRIPT_DEBUG : Force le chargement des versions non minifiées des fichiers JavaScript et CSS, utile pour déboguer des conflits.

Comment activer le Debug WordPress ?

Il existe plusieurs méthodes pour activer le debug dans WordPress :

Méthode 1 : Via FTP

Cette méthode est universelle et fonctionne avec tous les hébergeurs. Connectez-vous à votre site via FTP, téléchargez le fichier wp-config.php, modifiez-le pour activer les constantes de debug, puis renvoyez-le sur le serveur.

Méthode 2 : Via WP-CLI

Si vous avez accès à WP-CLI, cette méthode est rapide. Utilisez les commandes suivantes pour activer le debug :

wp config set WP_DEBUG true --raw
wp config set WP_DEBUG_LOG true --raw
wp config set WP_DEBUG_DISPLAY false --raw

Méthode 3 : Via le plugin WP Debugging

Pour ceux qui préfèrent une solution sans code, le plugin WP Debugging active automatiquement le mode debug. Il est facile à utiliser et ne nécessite aucune modification manuelle du code.

Lire et comprendre le fichier debug.log

Une fois le debug activé, vous devrez consulter le fichier debug.log pour identifier les erreurs. Ce fichier se trouve par défaut dans le dossier /wp-content/. Vous pouvez le lire via FTP ou utiliser WP-CLI pour afficher les erreurs en temps réel.

Les types d’erreurs PHP

Il est important de comprendre les différents types d’erreurs que vous pouvez rencontrer :

  • Fatal Error : Arrête le script. Priorité maximale.
  • Parse Error : Erreur de syntaxe. Le fichier ne peut pas être exécuté.
  • Warning : Indique un problème, mais le site continue de fonctionner.
  • Notice : Détail technique à corriger, pas urgent.
  • Deprecated : Utilisation d’une fonction obsolète, à mettre à jour.

Protéger le fichier debug.log

Le fichier debug.log peut contenir des informations sensibles. Il est crucial de le protéger en ajoutant des règles dans votre fichier .htaccess pour empêcher l’accès public.

Utiliser Query Monitor pour un diagnostic visuel

Query Monitor est un plugin qui fournit un tableau de bord visuel pour le debug. Il affiche les erreurs PHP, les requêtes SQL, et d’autres informations utiles directement dans votre barre d’administration WordPress.

Conclusion

Debug WordPress est un outil puissant pour diagnostiquer et corriger les erreurs sur votre site. En suivant ces étapes et en utilisant les outils appropriés, vous serez en mesure de résoudre rapidement les problèmes et de maintenir votre site en bon état de fonctionnement.

Source :

Url :

wpformation