Documentation du plugin

Voir les catégories

Comment vérifier les journaux WP_DEBUG dans WordPress

4 min lire

WP_DEBUG est une constante de WordPress qui active le mode de débogage, permettant aux développeurs de résoudre les problèmes en enregistrant les erreurs, les avertissements et les notifications. Ce guide explique comment vérifier les journaux WP_DEBUG en utilisant différentes méthodes.

Conditions préalables

  • Accès à votre installation WordPress (via le panneau de contrôle de l'hébergement, FTP ou SSH).
  • Compréhension de base des fichiers de configuration de WordPress.
  • WP_DEBUG activé dans votre wp-config.php . Pour l'activer, ajoutez ou modifiez les lignes suivantes :
define('WP_DEBUG', true ) ;
define('WP_DEBUG_LOG', true ) ;
define( 'WP_DEBUG_DISPLAY', false ) ; // Empêche l'affichage des erreurs sur le site

Méthode 1 : Vérification des journaux de débogage via l'accès aux fichiers

WordPress stocke les journaux de débogage dans un fichier lorsque WP_DEBUG_LOG est activée. Par défaut, le fichier journal est situé à l'adresse suivante wp-content/debug.logmais vous pouvez spécifier un emplacement personnalisé pour une meilleure organisation ou une meilleure sécurité.

Les étapes :

  1. Configuration de l'emplacement du journal:
  • Pour l'emplacement par défaut du journal, assurez-vous que WP_DEBUG_LOG est fixé à vrai en wp-config.php.
  • Pour un emplacement d'enregistrement personnalisé, ajoutez ou modifiez la ligne suivante dans le fichier wp-config.php pour spécifier un chemin d'accès :
define('WP_DEBUG_LOG', '/path/to/custom/debug.log' ) ;
  • Assurez-vous que le répertoire est accessible en écriture par le serveur web (par exemple, définissez les autorisations à 664 ou 666 pour le fichier et 755 pour le répertoire).
  1. Accéder à vos fichiers WordPress:
  • Utilisez un client FTP (par exemple, FileZilla) ou le gestionnaire de fichiers de votre hébergement pour accéder à votre installation WordPress.
  • Vous pouvez également utiliser SSH pour vous connecter à votre serveur pour un accès plus rapide.
  1. Localiser le journal de débogage:
  • Naviguez jusqu'à la page wp-content pour le journal par défaut (wp-content/debug.log) ou vers votre chemin d'accès personnalisé (par exemple, /path/to/custom/debug.log).
  • Si le fichier journal n'existe pas, assurez-vous que WP_DEBUG_LOG est correctement configuré et déclenche une action sur votre site (par exemple, l'actualisation d'une page) pour générer des journaux.
  1. Voir le journal:
  • Téléchargez le fichier journal et ouvrez-le avec un éditeur de texte (par exemple, Notepad++, VS Code).
  • Vous pouvez également utiliser SSH pour visualiser directement le fichier à l'aide d'une commande telle que cat wp-content/debug.log ou cat /path/to/custom/debug.log.
  1. Interpréter les journaux:
  • Les journaux comprennent les horodatages, les types d'erreurs (par exemple, Avertissement PHP, Avis PHP), et des détails sur le problème, y compris le fichier et le numéro de ligne à l'origine de l'erreur.

Notes :

  • La personnalisation de l'emplacement des journaux est utile dans les cas suivants wp-content n'est pas accessible en écriture ou pour organiser les journaux dans un répertoire sécurisé.
  • Assurez-vous que les chemins d'accès personnalisés ne sont pas accessibles au public afin d'éviter d'exposer des informations sensibles.
  • Si le fichier journal est volumineux, utilisez des outils tels que grep (par exemple, grep "PHP Error" wp-content/debug.log) pour filtrer des erreurs spécifiques.
  • Effacez régulièrement le fichier journal ou faites-le pivoter pour éviter qu'il ne devienne trop volumineux.

Méthode 2 : Utilisation d'un plugin de débogage

Plusieurs plugins WordPress simplifient le processus de visualisation des journaux de débogage sans accès direct aux fichiers.

Plugins recommandés :

  • Gestionnaire de journaux de débogage: Un plugin dédié à l'activation, la gestion et la visualisation des journaux de débogage.
  • Moniteur de requêtes: Affiche les informations de débogage, y compris les erreurs, directement dans le panneau d'administration de WordPress.
  • Barre de débogage: Ajoute un menu de débogage à la barre d'administration, affichant les journaux et autres données de débogage.

Les étapes :

  1. Installer un plugin:
  • Aller à Plugins > Ajouter un nouveau dans le panneau d'administration de WordPress.
  • Recherchez et installez le plugin de débogage de votre choix (par exemple, Debug Log Manager).
  • Activer le plugin.
  1. Accéder aux journaux de débogage:
  • Pour Gestionnaire de journaux de débogage, naviguez jusqu'à Outils > Gestionnaire de journaux de débogage dans le panneau d'administration de WordPress pour afficher, filtrer ou télécharger le journal de débogage. Le plugin vous permet également d'effacer les journaux ou de configurer les paramètres des journaux.
  • Pour Moniteur de requêtesPour afficher les erreurs et les journaux, allez dans le menu Moniteur de requêtes de la barre d'administration.
  • Pour Barre de débogagePour cela, cliquez sur la barre de débogage dans la barre d'administration et explorez la section des journaux.

Notes :

  • Les plugins peuvent nécessiter WP_DEBUG et WP_DEBUG_LOG à activer.
  • Debug Log Manager offre des fonctionnalités supplémentaires telles que le filtrage des journaux par type d'erreur et la gestion de la taille des fichiers journaux.

Méthode 3 : Débogage en temps réel avec un terminal

Pour les utilisateurs avancés, vous pouvez surveiller les journaux de débogage en temps réel à l'aide de SSH et de commandes de terminal.

Les étapes :

  1. Accéder à votre serveur via SSH:
  • Connectez-vous à votre serveur à l'aide d'un client SSH (par exemple, PuTTY ou un terminal).
  1. Surveiller le journal de débogage:
  • Exécutez la commande suivante pour consulter le fichier journal en temps réel :
tail -f wp-content/debug.log
  • Pour un emplacement d'enregistrement personnalisé, utilisez :
tail -f /path/to/custom/debug.log
  • Le -f permet d'afficher les nouvelles entrées du journal au fur et à mesure qu'elles sont écrites.
  1. Actions de déclenchement:
  • Effectuer des actions sur votre site WordPress (par exemple, rafraîchir une page, soumettre un formulaire) pour générer des entrées de journal.
  • Observer le terminal pour obtenir un retour d'information immédiat.

Notes :

  • Utilisation Ctrl+C pour arrêter la surveillance.
  • Combiner avec grep pour le filtrage (par exemple, tail -f wp-content/debug.log | grep "Erreur PHP").

Méthode 4 : Utilisation d'intégrations de journaux d'erreurs

Certains hébergeurs ou configurations de serveurs vous permettent d'intégrer les journaux de débogage de WordPress aux journaux d'erreurs du serveur ou à des outils de surveillance tiers.

Les étapes :

  1. Vérifier le panneau de contrôle de l'hébergement:
  • Connectez-vous au panneau de contrôle de votre hébergement.
  • Rechercher un Journaux d'erreurs ou Journaux section.
  • Si WP_DEBUG_LOG est configuré pour écrire dans un fichier accessible au serveur, des erreurs peuvent apparaître ici.
  1. Intégrer des outils tiers:
  • Utilisez des outils tels que New Relic, Sentinelleou Loggly pour collecter et analyser les journaux de débogage de WordPress.
  • Ces outils peuvent être configurés par des plugins ou par l'intermédiaire d'une commande directe. WP_DEBUG_LOG vers leurs API.

Notes :

  • Cette méthode nécessite une configuration supplémentaire et peut entraîner des coûts pour des services tiers.
  • Assurez-vous que votre environnement d'hébergement prend en charge les intégrations de journaux personnalisés.

Meilleures pratiques

  • Désactiver le débogage sur les sites en ligne: Ensemble WP_DEBUG à faux sur les sites de production afin d'éviter d'exposer des informations sensibles.
  • Fichiers journaux sécurisés: Garantir debug.log n'est pas accessible au public (par exemple, ajouter refuser à tous à .htaccess pour le fichier journal).
  • Entretien régulier: Effacer ou archiver périodiquement les journaux pour gérer l'espace disque.
  • Test dans la phase d'essai: Répliquer les problèmes dans un environnement d'essai afin d'éviter de perturber les sites réels.

Dépannage des problèmes courants

Non debug.log Fichier:

  • Vérifier WP_DEBUG et WP_DEBUG_LOG sont fixés à vrai en wp-config.php.
  • Vérifier si le wp-content ou le répertoire du journal personnalisé est accessible en écriture (les permissions doivent être de 755 pour les répertoires et 664 ou 666 pour les fichiers).

Les journaux sont vides:

  • Assurez-vous que les actions déclenchant des erreurs sont effectuées après avoir activé le débogage.
  • Vérifier la présence d'erreurs de syntaxe dans wp-config.php qui pourraient empêcher l'enregistrement.

Fichiers journaux volumineux:

  • Utilisez des outils de rotation des journaux ou des plugins tels que Debug Log Manager pour gérer la taille des fichiers.
  • Filtrer les journaux à l'aide d'outils tels que grep pour se concentrer sur les entrées pertinentes.

En utilisant ces méthodes, vous pouvez surveiller et résoudre efficacement les problèmes de votre site WordPress en utilisant les logs WP_DEBUG. Choisissez la méthode qui correspond le mieux à votre expertise technique et à votre environnement d'hébergement.

Quels sont vos sentiments ?