7 min de lecture
Pour lire les logs WordPress, partez d’un incident précis : une page, une action et une heure. Chercher le dernier message du fichier sans ce contexte peut conduire vers une ancienne alerte sans rapport. Nous allons distinguer les familles de logs, repérer les informations utiles et préparer une collecte limitée lorsque les traces existantes ne suffisent pas.
Journaux WordPress et fichiers d’erreurs : lesquels consulter ?
Les logs WordPress ne correspondent pas à un fichier universel contenant tous les problèmes du site. Le serveur web enregistre ses requêtes et ses erreurs ; PHP consigne les erreurs de traitement selon sa configuration ; certaines extensions disposent de leurs propres traces. Le journal de débogage du logiciel est un outil complémentaire.
| Source | Ce qu’on y cherche | Limite |
|---|---|---|
| Journal d’accès web | Chemin demandé, heure et statut HTTP | Un code ne révèle pas toute la cause. |
| Journal d’erreurs serveur/PHP | Échec de traitement ou de communication | L’emplacement dépend de l’hébergement. |
| debug.log | Messages collectés par le débogage WordPress | Il n’existe pas automatiquement sur chaque site. |
| Journal d’une extension | Événement d’un paiement, envoi ou autre intégration | Il ne décrit pas nécessairement toute la chaîne. |
Pour les logs WordPress, consultez d’abord le panneau de l’hébergement ou son aide. Un outil de lecture installé dans l’administration n’accède pas forcément aux journaux du serveur. Si le site ne charge plus, ajouter une extension peut être impossible ou ne rien apprendre sur l’échec qui survient avant son lancement.
Pour examiner les logs WordPress, recherchez aussi la rubrique error log ou journal d’erreurs de l’hébergement. Le nom de son écran ne garantit pas que toutes les sources y sont regroupées.
Comment voir les logs ?
- Repérer le bon site : installation publique ou copie, domaine et hébergement concernés.
- Ouvrir les journaux disponibles : rubrique de l’hébergeur, fichier autorisé ou journal propre à l’outil.
- Filtrer le bon moment : heure de l’incident, fuseau et action exacte avant de lire le message.
Les logs WordPress peuvent contenir des chemins internes, adresses IP et données saisies. Utilisez un accès autorisé et un éditeur adapté, sans envoyer le fichier complet dans un outil public. Le nom error.log est courant, mais il ne désigne pas toujours la même source ni le même emplacement.
Du symptôme à la trace
- Reproduire
Une seule action de test identifiée, si elle est sans conséquence indésirable.
- Noter
L’heure précise et le résultat attendu ou observé.
- Recouper
Le message correspondant dans la source concernée.
Avant d’ouvrir les logs WordPress, notez si l’action a réellement échoué. Un formulaire peut ne pas afficher sa confirmation alors qu’un envoi a été déclenché. Vérifiez son résultat avant de multiplier les essais, en particulier pour les commandes et notifications.
Pour consulter les logs WordPress dans les fichiers, un accès SFTP à la bonne installation ou le gestionnaire de l’hébergeur peut être nécessaire. Ouvrez la bonne installation et téléchargez seulement l’extrait utile. Un outil comme phpMyAdmin consulte la base MySQL : ce n’est pas, à lui seul, un lecteur des journaux d’erreurs du serveur web.
Comment lire un fichier de log sans accuser le mauvais composant ?
Repérez la date, le niveau du message, le texte, le fichier et la ligne quand ils existent. Une erreur fatale, un avertissement et un message de dépréciation n’ont pas la même portée. La répétition et la concordance avec l’action aident à prioriser, mais ne remplacent pas l’examen de l’appel.
Lire la structure d’un message
[heure fictive] PHP Fatal error: message — fichier-exemple.php:123. L’heure permet la corrélation ; le message décrit l’échec ; le fichier et la ligne situent son apparition. Cet extrait n’identifie aucun client ni incident réel.
- Distinguer les messages nouveaux d’anciennes entrées accumulées.
- Rechercher la première erreur liée à l’action plutôt que le dernier effet en cascade.
- Conserver l’extrait utile et le contexte, puis masquer données privées et secrets.
Les logs WordPress peuvent citer un fichier d’extension qui appelle un service externe défaillant. Cela ne prouve pas que le code de cette extension est fautif. Pour une panne de chargement, le guide de l’erreur critique complète l’interprétation avec le contexte des changements récents.
Exemple pédagogique : une ancienne alerte bruyante
Un fichier fictif contient mille messages de dépréciation de la veille, puis une erreur fatale à l’heure exacte de l’échec. La première priorité du diagnostic est cette dernière chaîne d’appel, sans affirmer que les autres messages peuvent être ignorés durablement.
Besoin d’interpréter une erreur du site ?
Je vous aide à rapprocher les traces du parcours en échec et à définir les corrections à tester.
Quand faut-il activer le mode debug WordPress ?
Si les traces existantes ne suffisent pas, le mode debug WordPress peut aider à collecter des informations sur une copie de test. La documentation officielle du débogage distingue WP_DEBUG, la journalisation et l’affichage. Ces réglages ne sont pas interchangeables.
Enregistrer sans afficher
Des messages sont enregistrés dans un emplacement protégé.
Définir le périmètre, les accès et la durée.
Des messages techniques apparaissent dans les pages.
À éviter sur le site accessible aux visiteurs.
Avec WP_DEBUG_LOG réglé sur true, le chemin habituel est wp-content/debug.log ; un chemin personnalisé peut être défini selon la configuration. Protégez son accès et vérifiez qu’il ne peut pas être téléchargé publiquement. Préférez une configuration encadrée sur une copie, avec sauvegarde et retour arrière, plutôt qu’un fragment ajouté au hasard dans le site public.
Le guide du fichier wp-config.php explique les précautions de modification. Les logs WordPress n’exigent pas de laisser le débogage permanent. Une collecte doit répondre à une question et être interrompue ou réajustée une fois l’analyse terminée.
Pas de secrets dans les traces. Ne journalisez pas volontairement mots de passe, clés d’API, cookies ou contenus de formulaire pour faciliter le diagnostic. Un extrait à transmettre doit être nettoyé et partagé par une voie adaptée.
Que transmettre et que vérifier après la correction ?
- L’action, l’adresse, l’heure et le résultat attendu.
- La source du journal et l’extrait utile nettoyé.
- Les versions ou opérations modifiées au même moment.
- La correction essayée et le résultat du même test après intervention.
Les logs WordPress doivent aider à vérifier une hypothèse. Après correction, refaites le parcours et vérifiez les données reçues ou enregistrées. L’absence d’un nouveau message ne démontre pas le succès d’une fonction qui ne produit aucun log lorsqu’elle échoue.
Pour une tâche planifiée, le guide du cron WordPress distingue le déclenchement et son résultat. Une notification envoyée ne prouve pas la réception du message ; un traitement lancé ne prouve pas son achèvement. Gardez dans le compte rendu ces étapes séparées.
Organisez enfin la conservation des logs WordPress selon leur utilité : accès limités, durée adaptée et rotation des fichiers. Un journal volumineux n’est pas une preuve de bonne surveillance. Un suivi régulier doit préciser qui examine les alertes et traite les erreurs récurrentes.
Questions fréquentes
L’absence de debug.log signifie-t-elle que le site va bien ?
Non. La collecte peut être désactivée, utiliser un autre chemin ou ne pas disposer des droits nécessaires. Vérifiez la configuration et les traces disponibles avant de conclure.
Comment recouper deux journaux dont les heures diffèrent ?
Relevez le fuseau affiché par chaque source et ramenez les heures au même fuseau. Comparez ensuite l’URL, l’action et, s’il existe, l’identifiant de requête. Deux messages proches dans le temps peuvent correspondre à des demandes différentes.
Puis-je effacer un journal trop gros ?
Préservez d’abord les traces utiles à l’incident et vérifiez leur politique de conservation. Le bon traitement peut être une rotation ou une configuration corrigée, pas une suppression improvisée pendant l’analyse.
Un relevé utile associe une action, une heure et une trace interprétée. Mon assistance WordPress peut vous aider à examiner ce contexte. Les logs WordPress servent à orienter puis vérifier un diagnostic ; ils ne remplacent pas le contrôle du parcours réel.
