Comment activer les journaux d’erreurs dans WordPress

Bien que WordPress soit relativement facile à gérer, les erreurs de dépannage sont un problème assez courant pour ses utilisateurs. Les gérer n’est généralement pas difficile – il suffit d’un peu de pratique. La première étape de chaque dépannage d’erreur WordPress consiste à récupérer le journal des erreurs.

Le journal des erreurs contient toutes les erreurs, avertissements et avis concernant le code de votre site. Cela peut parfois vous aider à identifier le fichier et la ligne de code exacts à l’origine du problème. Le journal des erreurs peut également fournir des indices pour résoudre les erreurs apparemment insolubles, telles que « l’écran blanc de la mort ».

Cependant, donner un sens au journal des erreurs peut être assez difficile si vous n’êtes pas féru de technologie. Pour devenir féru de technologie, vous devez commencer quelque part – commençons donc par vous montrer comment activer et acquérir le journal des erreurs dans WordPress.

Comment configurer les journaux d’erreurs WordPress dans votre fichier WP-Config

Le fichier wp-config.php est un fichier de configuration WordPress important. En le modifiant légèrement, vous activerez le débogage par défaut de WordPress et afficherez les erreurs. Vous pouvez le faire via un client FTP ou via cPanel.

Utilisation d’un client FTP

Une condition préalable pour effectuer des modifications sur vos fichiers de serveur est de définir correctement les autorisations de fichier. Les autorisations suggérées sur le fichier wp-config.php sont 440 ou 400. Cela signifie que vous n’êtes autorisé qu’à lire les fichiers. Pour pouvoir acquérir un journal des erreurs, vous devez modifier temporairement les autorisations de fichier en 644 ou 666. Pour plus de précision, 644 donne des autorisations de lecture et d’écriture/édition aux utilisateurs administrateurs, tandis que le reste des utilisateurs n’obtient que des autorisations de lecture. La valeur 666 donne les deux types d’autorisations susmentionnés à tous les utilisateurs.

Pour continuer, vous avez besoin d’un client FTP et de la connaissance de l’édition du fichier wp-config.php. Commencez par vous connecter au serveur en utilisant vos identifiants FTP. Accédez à votre répertoire racine de WordPress. Localisez le fichier wp-config.php, faites un clic droit dessus et sélectionnez le Option « Autorisations de fichier ».

Insérez manuellement l’une des valeurs numériques suggérées (644 ou 666) et cliquez sur « d’accord”.

Après avoir modifié les autorisations, revenez à la répertoire racine, faites un clic droit sur le fichier wp-config.php et sélectionnez « Voir la modification”.

Ouvrez le fichier à l’aide d’un éditeur de texte et insérez cette ligne de code :

define('WP_DEBUG', true);

au dessus du /* C’est tout, arrêtez d’éditer ! Bon blog. */.

Si la define('WP_DEBUG', false);  la ligne est déjà présente, seulement changer faux en vrai.

Enregistrez les modifications et téléchargez le fichier modifié dans votre répertoire WordPress racine. Cela remplacera le fichier qui est actuellement sur votre serveur.

Via cPanel

Vous pouvez également utiliser cPanel pour éditer le fichier wp-config.php. Connectez-vous au cPanel à l’aide de vos identifiants et cliquez sur le « Gestionnaire de fichiers”.

Naviguez vers le répertoire racine de votre installation WordPress sur la gauche, localisez le fichier wp-config.php, faites un clic droit dessus et sélectionnez « Modifier les autorisations”.

Assurez-vous de activer les autorisations de lecture et d’écriture pour l’utilisateur (admin) en cochant la case appropriée. Ensuite, cliquez sur « Modifier les autorisations”.

Ensuite, faites un clic droit sur le fichier wp-config.php une fois de plus et sélectionnez « Éditer”.

Le fichier s’ouvrira dans l’éditeur cPanel par défaut, donc il vous suffit d’ajouter le define('WP_DEBUG', true); au dessus de /* That's all, stop editing! Happy blogging. */ ligne de code dans le fichier wp-config.

Si le fichier contient déjà la ligne suivante define('WP_DEBUG', false); changez simplement le faux en vrai et cliquez sur « Enregistrer les modifications » dans le coin supérieur droit de votre écran.

Comment gérer l’affichage des erreurs

Une fois que vous avez réussi à afficher les erreurs, elles s’afficheront sur vos pages, à la fois sur le backend et le frontend. À moins que votre site ne soit en cours de développement, exposer les erreurs en direct n’est clairement pas une bonne idée. Au lieu de cela, vous devez les enregistrer dans un seul fichier et les masquer de votre site. Cela vous permettra de visualiser le fichier plus tard et de résoudre les erreurs à tout moment.

Pour faire ça, ajoutez ce code à votre fichier wp-config.php.

define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
@ini_set( 'display_errors', 0 );

Ajoutez le code sous la ligne suivante define('WP_DEBUG', true);  et au dessus du /* That's all, stop editing! Happy blogging. */ ligne de code.

Vous pouvez modifier le fichier à l’aide d’un client FTP ou via cPanel, en suivant les mêmes étapes que celles décrites dans la section précédente. Après la modification, votre fichier wp-config.php devrait ressembler à ceci.

En ajoutant define( ‘WP_DEBUG_LOG’, true ); nous forçons WordPress à stocker tous les messages d’erreur dans un seul fichier. Par défaut, ce fichier s’appelle debug.log et se trouve dans votre répertoire racine WordPress/wp-content/. Vous pouvez également stocker des messages d’erreur dans un autre fichier que vous avez créé. Dans ce cas, remplacez le vrai par « define( ‘WP_DEBUG_LOG’, true ); » au chemin du fichier. Par exemple:

define( 'WP_DEBUG_LOG', path-to-your-site/wp-content/error.log );

Par ailleurs, WP_DEBUG_DISPLAY détermine si les messages d’erreur sont affichés ou masqués à l’écran. En ajoutant define( ‘WP_DEBUG_DISPLAY’, false ); vous dites à WordPress de masquer les messages de votre écran, mais ils sont toujours imprimés dans le fichier désigné. Si vous aussi add @ini_set( ‘display_errors’, 0 ); cela désactivera l’impression des erreurs pour votre PHP, en veillant à ce que les utilisateurs ne puissent pas les voir sur le frontend.

Acquisition du journal des erreurs

Avec les erreurs affichées et écrites avec succès dans le fichier journal d’erreurs approprié, il ne reste plus qu’à examiner les messages d’erreur et à prendre des mesures supplémentaires.

Téléchargement manuel du fichier debug.log

Pour télécharger le fichier journal connectez-vous à votre serveur, accédez à votre dossier racine WordPress et cliquez sur contenu wp. Trouvez le journal de débogage fichier à l’intérieur, clic-droit dessus et appuyez sur « Télécharger”.

Enregistrez le fichier sur votre bureau. Ensuite, assurez-vous d’annuler les modifications précédentes. Cela inclut la suppression du code que vous avez inséré et la modification des autorisations sur le fichier wp-config.php en 440 ou 400. Si vous le souhaitez, vous pouvez le faire après avoir résolu les erreurs.

Enfin, ouvrez le fichier debug.log enregistré avec un éditeur de texte et vérifiez les messages d’erreur écrits. Selon votre niveau d’expertise, vous pouvez soit résoudre les erreurs vous-même, soit embaucher un développeur.

Fonctionnalités de débogage plus avancées

Nous examinerons également quelques possibilités de débogage plus avancées. Le code suivant doit être ajouté dans wp-config.php, au-dessus du /* That's all, stop editing! Happy blogging. */ ligne.

Ce code oblige WordPress à utiliser des versions non-minifiées des fichiers CSS et JS, ce qui est utile pour déboguer les modifications et/ou les erreurs trouvées spécifiquement dans vos fichiers CSS et JS.

En définissant la constante CONCATENATE_SCRIPTS sur false, vous forcez WordPress pour charger tous les scripts séparément. Cela peut s’avérer utile pour identifier les scripts défectueux/incompatibles.

Si vous rencontrez des problèmes de base de données, l’analyse des requêtes exécutées est un bon moyen de commencer le débogage. En insérant le code ci-dessus, vous mettre le contenu de la requête, quelle fonction l’a appelée et pendant combien de temps elle a été exécutée dans le tableau $wpdb->queries. Cela vous permettra de plonger plus profondément dans la partie backend du code du thème et ce qu’il fait exactement.

Vous pouvez alors ajoutez le code suivant pour afficher toutes les requêtes sous une forme lisible et les analyser.

global $wpdb;
print("<pre>".print_r($wpdb->queries,true)."</pre>");

Cependant, gardez à l’esprit que ce code affectera les performances de votre site, nous vous recommandons donc de l’utiliser à des fins de débogage uniquement.

Dernières pensées

En suivant ce guide, vous pouvez afficher et stocker en toute sécurité les journaux d’erreurs dans un fichier, modifier les autorisations de fichier et exécuter certaines fonctionnalités de débogage destinées aux utilisateurs WordPress plus avancés. Ce didacticiel vous aidera également à en savoir plus sur le fonctionnement de votre site Web. Gardez-le donc à portée de main, car vous pourriez avoir besoin de ces instructions à l’avenir.