Boîte à Outils Informatique
Guide

Comment activer les logs de debug WordPress

Enregistrer les erreurs WordPress dans un fichier de log sans les afficher aux visiteurs.

ThématiqueWordPress →
⌚ Environ 3 min de lecture
Voir mes favoris
WordPress Intermédiaire 5 min

Enregistrer les erreurs WordPress dans un fichier de log sans les afficher aux visiteurs.

Avant de commencer : adaptez toujours les commandes et manipulations à votre environnement. Sur un système de production, prévoyez une sauvegarde ou un retour arrière lorsque l’action peut modifier la configuration.

Étapes à suivre

  1. 1

    Sauvegarder wp-config.php

    Conservez une copie du fichier.

  2. 2

    Activer WP_DEBUG

    Définissez WP_DEBUG à true.

  3. 3

    Activer WP_DEBUG_LOG

    Ajoutez WP_DEBUG_LOG à true.

  4. 4

    Masquer les erreurs à l’écran

    Définissez WP_DEBUG_DISPLAY à false.

  5. 5

    Consulter le fichier debug.log

    Il est généralement créé dans wp-content/debug.log.

  6. 6

    Désactiver le debug après diagnostic

    Évitez de conserver inutilement des logs volumineux ou sensibles.

Commandes utiles

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

À retenir

  • Ne partagez pas publiquement un debug.log sans l’examiner : il peut contenir des chemins, requêtes ou informations sensibles.
  • Sur un site public, masquez l’affichage direct des erreurs.
← Tous les guides
Complément technique

WordPress : enrichir le diagnostic sans masquer la cause

Repères techniques

  • WP_DEBUG_LOG écrit généralement dans wp-content/debug.log seulement si WP_DEBUG est activé et si le processus PHP peut écrire le fichier.
  • Renommer le dossier d’un plugin désactive son chargement sans modifier la base, ce qui est utile quand wp-admin est inaccessible.
  • WP_MEMORY_LIMIT ne peut pas dépasser les limites réellement accordées par PHP/hébergeur ; une erreur mémoire exige de lire memory_limit et le pic.

Récupération contrôlée

Isoler le plugin ou la couche fautive, garder les logs, puis réactiver un composant à la fois.

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Pièges spécifiques

  • Supprimer .maintenance, un plugin ou le cache sans noter l’état initial peut faire disparaître le symptôme sans expliquer la cause.
  • Une boucle de redirection peut venir de WordPress, du proxy/CDN, HTTPS ou d’un plugin : vérifier chaque couche séparément.

Comment valider

  • Le site charge avec les logs propres et le composant fautif est identifié, pas seulement désactivé.
  • Les constantes de debug temporaires sont retirées ou adaptées après l’intervention.

Preuves et vérifications

WP_DEBUG_LOG écrit généralement dans wp-content/debug.log seulement si WP_DEBUG est activé et si le processus PHP peut écrire le fichier. Renommer le dossier d’un plugin désactive son chargement sans modifier la base, ce qui est utile quand wp-admin est inaccessible.

Contrôle de résultat

Le site charge avec les logs propres et le composant fautif est identifié, pas seulement désactivé. Les constantes de debug temporaires sont retirées ou adaptées après l’intervention.

Point d’attention

Supprimer .maintenance, un plugin ou le cache sans noter l’état initial peut faire disparaître le symptôme sans expliquer la cause. WP_MEMORY_LIMIT ne peut pas dépasser les limites réellement accordées par PHP/hébergeur ; une erreur mémoire exige de lire memory_limit et le pic.

Concepts liés

Référence primaire : WordPress Developer Resources — Debugging.

♡ 0