Votre site WordPress affiche des erreurs cryptiques ou se comporte bizarrement ? Le mode debug est votre meilleur allié pour identifier les problèmes. Ce tutoriel vous guide pas à pas pour activer le débogage, comprendre les messages d’erreur et résoudre les problèmes courants.
Pré-requis et vision d’ensemble
Avant de commencer, assurez-vous d’avoir :
- Un accès FTP ou un gestionnaire de fichiers (comme FileZilla ou cPanel)
- Les identifiants d’administration WordPress
- Une sauvegarde récente de votre site (obligatoire !)
- Un éditeur de texte (Notepad++, Visual Studio Code, etc.)
Le temps nécessaire varie de 10 à 30 minutes selon votre expérience.
Tutoriel pas-à-pas
Étape 1 : Accéder au fichier wp-config.php
Objectif : Localiser le fichier de configuration principal de WordPress.
- Connectez-vous à votre hébergement via FTP ou le gestionnaire de fichiers
- Naviguez jusqu’au dossier racine de votre installation WordPress
- Trouvez le fichier
wp-config.php(souvent dans le dossier public_ ou www)
Vérification : Le fichier doit contenir des lignes comme define('DB_NAME', 'nom_de_votre_base')
Erreur fréquente : Si vous ne trouvez pas le fichier, vérifiez que vous êtes bien dans le bon dossier racine. Certains hébergeurs cachent WordPress dans un sous-dossier.
Étape 2 : Activer le mode debug
Objectif : Configurer WordPress pour afficher les erreurs.
- Ouvrez
wp-config.phpavec votre éditeur de texte - Ajoutez ces lignes avant
/ That's all, stop editing! Happy blogging. /:define('WP_DEBUG', true) define('WP_DEBUG_LOG', true) define('WP_DEBUG_DISPLAY', false) - Enregistrez le fichier
Vérification : Les erreurs devraient maintenant s’afficher dans le fichier debug.log dans le dossier /wp-content/
Erreur fréquente : Si vous voyez un écran blanc, désactivez WP_DEBUG_DISPLAY ou vérifiez les droits d’écriture.
Étape 3 : Configurer le débogage avancé
Objectif : Affiner le débogage pour des besoins spécifiques.
- Pour déboguer les requêtes SQL, ajoutez :
define('SAVEQUERIES', true) - Pour activer le débogage des scripts :
define('SCRIPT_DEBUG', true) - Pour déboguer les thèmes :
define('WP_DEBUG_DISPLAY', true)
Vérification : Les informations supplémentaires devraient apparaître dans le fichier de log ou à l’écran selon vos paramètres.
Erreur fréquente : SCRIPT_DEBUG peut ralentir votre site – désactivez-le après utilisation.
Bonnes pratiques / Optimisations
Pour un débogage efficace et sécurisé :
- Toujours désactiver WP_DEBUG_DISPLAY en production
- Surveiller la taille du fichier debug.log (le vider régulièrement)
- Utiliser des plugins comme Query Monitor pour un débogage visuel
- Documenter les erreurs avec des commentaires dans le fichier de log
FAQ ciblée
1. Où se trouve le fichier debug.log ?
Dans le dossier /wp-content/ de votre installation WordPress.
2. Puis-je activer le debug sur un site en production ?
Oui, mais uniquement avec WP_DEBUG_DISPLAY désactivé pour éviter d’exposer des informations sensibles.
3. Comment désactiver le debug ?
Changez WP_DEBUG en false ou supprimez les lignes de configuration.
4. Que faire si le fichier debug.log n’existe pas ?
Vérifiez que WP_DEBUG_LOG est bien activé et que le dossier /wp-content/ a les bons droits d’écriture.
5. Comment déboguer un thème spécifique ?
Activez WP_DEBUG_DISPLAY et testez en changeant de thème pour isoler le problème.
Ressources fiables
- Documentation officielle WordPress sur le debug
- Codex WordPress sur le débogage
Conclusion
Le mode debug WordPress est un outil puissant pour identifier et résoudre les problèmes techniques. En suivant ces étapes, vous pourrez analyser efficacement votre site et corriger les erreurs.
Si vous avez besoin d’aide, contactez un webmaster sérieux qui va vous aider dans vos tâches de site internet. Voici le numéro de téléphone : 09 77 29 09 69
Commentaires (1)
Merci pour ce guide détaillé ! J’ai enfin pu activer le mode debug sur mon site WordPress et comprendre les erreurs.