Comment accéder aux journaux d’erreurs de WordPress (guide complet)

À un moment donné, tous les sites WordPress sont victimes d’une erreur. Avec autant de roues en mouvement dans WordPress, quelque chose se casse, provoquant une erreur.

Bien qu’il s’agisse de l’un des systèmes de gestion de contenu (CMS) les plus fiables et les mieux pris en charge, WordPress n’est pas non plus à l’abri de problèmes. Dans de tels cas, les journaux d’erreurs peuvent s’avérer inestimables car ils identifient le problème exact et permettent de gagner un temps précieux.

Heureusement, WordPress peut générer des journaux d’erreurs chaque fois qu’il y a un problème. Lisez ce guide pour apprendre comment activer les journaux d’erreurs WordPress, comment ils vous aident, et comment les trouver et y accéder.

C’est l’un des fichiers de base de WordPress les plus essentiels pour gérer les paramètres WordPress essentiels. Une fois le fichier wp-config.php modifié, votre site Web commencera à générer un journal d’erreurs que vous pouvez accéder et examiner.

Lisez votre lecture pour obtenir des instructions détaillées sur la façon d’activer les journaux d’erreurs de WordPress.

• Étape 1. Accédez aux fichiers de votre site Web WordPress

  Pour commencer, vous devriez accéder à votre dossier d’installation de WordPress. Il y a plusieurs façons de le faire, mais généralement, les deux les plus populaires sont l’utilisation d’un gestionnaire de fichiers sur votre compte d’hébergement ou un programme FTP (comme FileZilla) connecté à un compte FTP.

  FTP

  Si vous avez choisi de gérer les fichiers de votre site Web via FTP, vous avez besoin d’un client FTP et un compte FTP qui autorise l’accès aux fichiers.

  Après vous être connecté à votre compte FTP, naviguez pas vers le dossier racine du site Web. Le chemin peut varier en fonction de votre configuration d’hébergement. Le chemin le plus courant pour le dossier racine des sites Web WordPress est :

  votresite.com/public_html

  

  Les clients SiteGround peuvent activer l’accès SFTP à tous leurs sites Web en utilisant des identifiants SFTP uniques. Pour en savoir plus, lisez ce guide sur SFTP multisite de SiteGround.

  Gestionnaire de fichiers

  De nombreux hébergeurs proposent des outils de gestion de fichiers de sites Web. Au lieu de créer un compte FTP et de le connecter avec un programme FTP (client), vous pouvez ouvrir les fichiers de votre site Web en quelques clics.

  Les clients SiteGround peuvent accéder aux fichiers de leur site Web depuis Site Tools > Site > Gestionnaire de fichiers. Lisez ce guide sur la gestion de vos fichiers avec le gestionnaire de fichiers pour plus d’informations.

  Le dossier racine de chaque site Web WordPress dans les Site Tools est:

  votresite.com/public_html

  

• Étape 2. Recherchez et modifiez le fichier wp-config.php

  Maintenant que vous êtes dans le répertoire racine, vous devez repérer et modifier le fichier wp-config.php pour activer le mode débogage de WordPress et les journaux de WordPress. Voici la différence entre utiliser un client FTP et un gestionnaire de fichiers.

  FTP

  La plupart des clients FTP ne peuvent pas modifier les fichiers directement sur le serveur FTP. Par conséquent, vous devez télécharger le fichier wp-config.php sur votre ordinateur local pour pouvoir le modifier.

  Par exemple, si vous utilisez FileZilla, sélectionnez wp-config.php dans la fenêtre de droite qui représente les fichiers sur le serveur FTP. Faites un clic droit dessus et choisissez Télécharger.

  

  Une fois que vous avez téléchargé le fichier, vous pouvez modifier le code avec n’importe quel éditeur de texte comme Notepad (pour Windows) ou TextEdit (pour Mac).

  

  Gestionnaire de fichiers

  Éditer le fichier wp-config.php depuis un gestionnaire de fichiers est plus direct. Sélectionnez le fichier et choisissez Modifier pour l’ouvrir en mode éditeur de texte.

  

• Étape 3. Activer le mode débogage et les journaux d'erreurs dans wp-config.php

Le fichier wp-config.php de base de WordPress contient de nombreux paramètres généraux pour votre site WordPress. Tout d’abord, repérez la ligne indiquant « /* That’s all, stop editing! Happy publishing. */ » ou « /* That’s all, stop editing! Happy blogging. */ »(pour les anciennes versions de WordPress).

Juste au-dessus, vous pouvez ajouter les commandes activant le mode débogage de WordPress et le journal des erreurs de WordPress.

IMPORTANT ! Un code incorrect dans le fichier de configuration WordPress peut provoquer des erreurs sur votre site Web. Créez une sauvegarde de votre site Web ou du fichier de configuration WordPress avant de modifier le code. Vous pourrez alors restaurer votre site Web à partir de cette sauvegarde si vous faites une erreur de syntaxe.

Pour activer le mode débogage, ajoutez la ligne suivante :

define( 'WP_DEBUG', true );

IMPORTANT ! En activant le mode débogage de WordPress, votre site Web affichera un message d’erreur pour chaque problème sur les pages d’accueil visibles par tous les visiteurs.

Pour activer la journalisation des erreurs dans un fichier de journal d’erreurs, ajoutez le code suivant :

define( 'WP_DEBUG_LOG', true );

IMPORTANT ! Les dernières versions de WordPress désactivent explicitement le mode débogage. Ainsi, wp-config.php est fourni avec le code « define( ‘WP_DEBUG’, false ); ». Si votre fichier de configuration contient cette ligne, remplacez simplement false par true.

Voici à quoi ressemble le fichier wp-config.php une fois les deux lignes ajoutées.



FTP

Une fois que vous avez modifié le fichier wp-config.php sur votre ordinateur, vous devez envoyer le fichier mis à jour sur votre site Web via FTP.

Reconnectez-vous à votre site Web via un compte FTP, allez dans le répertoire racine et envoyez le fichier wp-config.php.



Puisque vous remplacez la version actuelle du fichier de configuration de votre site Web par celle que vous avez modifiée, le logiciel FTP vous demandera de confirmer l’écrasement du fichier existant. Confirmez l’action pour continuer et activez le journal des erreurs de WordPress.

Gestionnaire de fichiers

Si vous avez choisi de modifier le fichier wp-config.php directement avec un gestionnaire de fichiers dans le panneau de contrôle de votre compte d’hébergement, vous avez juste à confirmer les changements. Cliquez sur le bouton Enregistrer pour conserver les paramètres permettant le journal d’erreurs de WordPress.

Le chemin complet du fichier est :

votresite.com/public_html/wp-content/debug.log

Vous pouvez télécharger le fichier en utilisant un client FTP et l’ouvrir avec un logiciel d’édition de texte sur votre ordinateur ou simplement utiliser un gestionnaire de fichiers dans votre panel d’hébergement.

Les utilisateurs de SiteGround peuvent afficher le fichier debug.log avec les Site Tools > Site > Gestionnaire de fichiers en le sélectionnant et en choisissant Modifier.

Le fichier conserve une trace de toutes les erreurs WordPress survenues sur votre site Web dans l’ordre chronologique.

Assistance sur les journaux d’erreurs de WordPress

Les journaux d’erreurs de WordPress fournissent des informations détaillées sur les problèmes rencontrés sur votre site Web. Ils enregistrent les erreurs PHP existantes, vous aidant à identifier et résoudre rapidement les problèmes. Cela peut être particulièrement utile pour diagnostiquer des problèmes de code PHP qui ne sont pas immédiatement apparents. Par exemple, celles qui se produisent en arrière-plan ou seulement dans des circonstances spécifiques.

Les journaux contiennent des informations détaillées qui sont extrêmement utiles pour résoudre des problèmes, des problèmes de compatibilité, etc.

Chaque entrée contient les informations suivantes :

• Horodatage de l’apparition de l’erreur
• Description de l’erreur
• Le chemin complet du fichier contenant l’erreur
• La ligne de code où l’erreur s’est produite

Comment corriger les erreurs en utilisant les journaux d’erreurs de WordPress

Les fichiers journaux de débogage de WordPress sont indispensables pour résoudre les problèmes de votre site Web. En fonction de votre expertise, de votre expérience et de vos préférences, vous pouvez les utiliser de nombreuses façons.

Corriger les erreurs dans les fichiers WordPress

Les utilisateurs avancés de WordPress peuvent utiliser les informations du journal de débogage pour identifier le fichier et la ligne contenant des problèmes de codage. Si vous êtes à l’aise pour éditer les fichiers manuellement, vous pouvez facilement trouver la cause et corriger la syntaxe ou d’autres problèmes.

Visitez les forums WordPress

Même si vous n’êtes pas certain du problème, il est très probable que quelqu’un l’a déjà rencontré et résolu. Le forum d’assistance WordPress est une source inépuisable d’informations, permettant à des millions d’utilisateurs de WordPress de partager leurs expériences et de s’entraider.

Vous pouvez toujours rechercher votre problème dans le forum ou rapporter l’erreur dans un nouveau sujet de discussion. Si vous démarrez un nouveau fil de discussion, vous pouvez mieux illustrer le problème en incluant les codes d’erreur provenant des journaux de débogage. Cela permettra aux experts de WordPress de vous fournir une solution précise.

Restaurer les sauvegardes

Vous n’avez pas à résoudre les problèmes à la main tout le temps. Parfois, résoudre des problèmes avec WordPress est aussi simple que de restaurer la sauvegarde d’un site Web.

En étudiant les journaux d’erreurs et les journaux d’accès de WordPress, vous pouvez décider si une restauration de sauvegarde est une solution appropriée.

Ensuite, en fonction des outils à votre disposition, vous pouvez restaurer votre site Web. Les utilisateurs de WordPress peuvent utiliser des sauvegardes des plugins WordPress ou un système de sauvegarde dans leur hébergement.

Les utilisateurs de SiteGround bénéficient d’un système de sauvegarde entièrement automatisé qui stocke les sauvegardes quotidiennes des 30 derniers jours. Pour en savoir plus, lisez ce guide sur la façon d’utiliser l’outil de sauvegarde de site Web SiteGround.

Contacter un développeur

Certains problèmes peuvent être trop accablants et complexes pour être traités seul. L’un des avantages de WordPress est qu’il entretient une forte communauté de développeurs spécialisés dans toutes sortes de problèmes liés à WordPress. Ainsi, quelle que soit la gravité de l’erreur, vous trouverez des experts WordPress qui peuvent vous donner un coup de main.

Vous pouvez trouver un développeur sur les forums WordPress, les sites Web d’indépendants, etc. Découvrez ce que disent les commentaires de leurs clients et examinez leurs services.

Les utilisateurs et utilisatrices de SiteGround peuvent bénéficier de remises exclusives sur les services de développement WordPress de la part de nos partenaires spécialisés dans les problématiques liées à WordPress. Vous trouverez plus d’informations dans votre Espace client > Place du marché > Avantages des partenaires.

Bonnes pratiques pour gérer les journaux d’erreurs de WordPress

Sans aucun doute, les journaux WordPress sont extrêmement utiles pour diagnostiquer et résoudre les problèmes critiques sur votre site Web. Cependant, comme toute autre facette de votre site Web, les journaux d’erreurs WordPress nécessitent une gestion assidue. Voici quelques directives générales pour l’utilisation de la journalisation des erreurs de WordPress.

1. Vérifier régulièrement les journaux de débogage : Prenez l’habitude de vérifier la présence de nouveaux messages d’erreur dans le journal d’erreurs. Une surveillance régulière vous aide à détecter les problèmes avant qu’ils ne dégénèrent.
2. Compréhension des messages d’erreur : En examinant les fichiers journaux, vous rencontrerez différents types de messages d’erreur. Comprendre ce qu’ils signifient est crucial pour un dépannage efficace. Les erreurs courantes sont les avertissements, les notifications et les erreurs fatales, chacun indiquant un niveau de gravité différent.
3. Utilisez les plugins de débogage WP : Si vous n’êtes pas à l’aise avec l’édition de fichiers ou si vous voulez plus de contrôle sur la journalisation, pensez à utiliser un plugin de débogage WP conçu pour la gestion des erreurs. Des plugins comme Query Monitor ou WP Log Viewer offrent des interfaces conviviales pour activer le mode de débogage de WordPress et pour afficher et gérer les journaux d’erreurs de WordPress.
   

   

4. Nettoyer les journaux : Les journaux d’erreurs de WordPress peuvent devenir volumineux avec le temps, ce qui rend la navigation difficile. Sans compter qu’ils peuvent épuiser l’espace du serveur Web. Effacez régulièrement les anciennes entrées du journal des erreurs de WordPress, en particulier après avoir résolu les problèmes. Cela permet de conserver une taille de fichier gérable et de repérer plus facilement un nouveau code d’erreur.
5. Sécurisez vos journaux : Les journaux de WordPress peuvent contenir des informations sensibles. Il est important d’en restreindre l’accès. Vous pouvez faire cela en définissant les permissions appropriées sur les fichiers ou en utilisant les règles .htaccess pour empêcher l’accès direct au journal des erreurs.
6. Utiliser les journaux pour le développement, pas sur les sites en ligne : Idéalement, vous devriez activer le mode débogage de WordPress dans un environnement de préproduction ou de développement, et non sur un site en ligne. L’outil WordPress Staging de SiteGround peut être très utile à cette fin.
   

   

   Si vous préférez toujours travailler directement sur votre site en ligne, n’oubliez pas de désactiver le mode de débogage de WordPress sur votre site en ligne en définissant « WP_DEBUG » sur false une fois les problèmes résolus.

7. Sauvegarder avant le dépannage : avant d’apporter des modifications à votre site en fonction des informations du journal, assurez-vous d’avoir une sauvegarde récente. Cela vous permet de restaurer votre site en cas de problème lorsque vous résolvez les erreurs.
   

   

Résumé

Chaque site WordPress tombe en panne à un moment donné malgré tous les efforts de son propriétaire. Résoudre les problèmes et corriger les erreurs de sites Web est une tâche courante dans la routine quotidienne d’un webmestre.
Pour vous aider à réparer votre site Web, WordPress dispose d’un mode de débogage qui enregistre toutes les erreurs existantes. Apprendre à activer le mode de débogage de WordPress et à accéder aux journaux d’erreurs de WordPress est une compétence essentielle qui vous aidera à isoler et à résoudre les problèmes rapidement avant qu’ils ne nuisent à la réputation de votre site.

Le but de ce guide était d’expliquer comment activer le mode débogage de WordPress, comment les journaux d’erreurs WordPress peuvent aider votre site Web, et comment les trouver et y accéder. Avec ces nouvelles connaissances, nous sommes certains que vous aborderez les problèmes des sites Web avec un niveau plus élevé de confiance.

FAQ sur les journaux WordPress

Comment nettoyer un fichier de journal d’erreurs WordPress ?

Pour nettoyer le journal des erreurs de WordPress, supprimez-le régulièrement via un gestionnaire de fichiers ou un programme FTP. Le fichier sera régénéré automatiquement, n’enregistrant que les nouvelles erreurs. Vous pouvez également télécharger le fichier sur votre ordinateur local pour conserver un historique des erreurs précédentes.

Puis-je supprimer les fichiers journaux de WordPress ?

Oui, vous pouvez supprimer les journaux d’erreurs de WordPress en toute sécurité. Ces fichiers ne sont pas critiques pour les sites WordPress.

Est-il sûr de modifier les erreurs dans les fichiers journaux de WordPress ?

Non, la modification de fichiers contenant des erreurs enregistrées dans le fichier de journalisation de WordPress n’est pas sûre. Si vous n’êtes pas certain de la solution, les modifications que vous avez apportées au code peuvent entraîner d’autres complications. Avant de modifier de tels fichiers, prenez des mesures de sécurité telles que la création d’une sauvegarde de votre site Web ou la modification des fichiers sur une copie de test, et non sur le site de production.