Comment activer et utiliser le journal de débogage de WordPress : le guide complet

Lorsque vous gérez un site web WordPress, vous rencontrezécran videetdysfonctionnementpeut-êtreProblèmes de chargement des pagesest un phénomène relativement courant. WordPress dispose d'un outil de débogage intégré qui permet aux journaux de débogage de détecter les erreurs et de nous aider à identifier et à résoudre les problèmes.

Cet article explique en détail comment activer et utiliser les journaux de débogage de WordPress, et comment utiliser la fonction de débogage plus efficacement pour résoudre les problèmes du site web.

1) Trouver et activer le journal de débogage de WordPress (wp-config.php)

Le débogage de WordPress se fait par l'intermédiaire de l'optionmodifications wp-config.php pour l'activer. Ce fichier se trouve dans le répertoire racine de votre site web et contrôle la configuration de base de WordPress. Il est activé par l'intermédiaire de l'optionActiver la journalisation de débogageNous pouvons enregistrer tous les messages d'erreur dans un fichier en vue d'un dépannage ultérieur.

Les étapes :

1. Connectez-vous au serveur à l'aide d'un client FTP (tel que FileZilla) ou de l'outil de gestion de fichiers de l'hôte.
2. Dans le répertoire racine (généralement public_html peut-être www ) pour trouver le wp-config.php Documentation.
3. Téléchargez le fichier et ouvrez-le avec un éditeur de texte tel que Notepad++.

4. Dans le fichier, vous trouverez quelque chose comme define( 'WP_DEBUG', false ); Les lignes qui seront faux se transformer en vrai. Si la ligne n'existe pas, vous pouvez l'ajouter manuellement :define( 'WP_DEBUG', true );
5. Enregistrez et téléchargez le fichier, en remplaçant l'original wp-config.php Documentation.

Cette action active les fonctions de débogage de base de WordPress. Si la page contient des erreurs, le message d'erreur sera affiché sur la page d'accueil. C'est utile pour les développeurs, mais si le site est en ligne et ouvert au public, il est recommandé d'enregistrer les erreurs dans les journaux plutôt que de les afficher directement.

2. constantes PHP optionnelles à des fins de débogage

Lorsque le mode débogage est activé, il est également possible de modifier les paramètres de la fonction wp-config.php Ajouter plus d'options de contrôle. Voici deux constantes PHP très importantes qui améliorent la journalisation du débogage pour le développement et le dépannage.

WP_DEBUG_DISPLAY

Cette constante détermine si les informations de débogage sont affichées sur le front-end. Si le site est public, il est recommandé de la désactiver pour éviter d'exposer les détails du site aux visiteurs ou aux attaquants potentiels.

define('WP_DEBUG_DISPLAY', false ) ;<br>
define('WP_DEBUG_DISPLAY', false ) ;<br>
define('WP_DEBUG_DISPLAY', false ) ;

WP_DEBUG_LOG

Cette constante permet d'enregistrer les informations de débogage dans un fichier journal au lieu de les afficher directement sur la page web. Lorsqu'elle est activée, toutes les informations de débogage sont enregistrées dans le fichier wp-content/debug.log Documentation.

define( 'WP_DEBUG_LOG', true ) ;<br>
define( 'WP_DEBUG_LOG', true ) ;<br>
define( 'WP_DEBUG_LOG', true ) ;

Un exemple de configuration complète est présenté ci-dessous :

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


Ce paramètre permet de s'assurer que les informations de débogage ne sont disponibles qu'en cas de besoin.Stocké dans le journalet ne seront pas affichés dans la partie frontale afin d'éviter d'exposer des informations sensibles.

3. comment afficher les journaux de débogage de WordPress

Lorsque la journalisation de débogage est activée, tous les messages d'erreur sont consignés dans le fichier wp-content/debug.log Ce fichier journal enregistre toutes les erreurs PHP, les avertissements et les notifications qui se produisent. Ce fichier journal enregistre toutes les erreurs, les avertissements et les notifications PHP qui se produisent. L'affichage du journal permet de comprendre la cause première du problème, en particulier si un plugin ou un thème est à l'origine du problème.

Les étapes :

1. Utilisez un client FTP ou un outil de gestion des fichiers de l'hôte pour accéder au fichier wp-content Dossier.

2. localiser debug.log cliquez avec le bouton droit de la souris pour le télécharger localement.
3. Ouvrez le fichier à l'aide d'un éditeur de texte pour afficher les erreurs, les avertissements et les notifications consignés.

Chaque ligne du journal de débogage contient un horodatage, un niveau d'erreur et un message d'erreur pour vous aider à identifier le problème. Exemple :

[28-Jul-2024 20:28:17 UTC] PHP Deprecated : Using ${var} in strings is deprecated, use {$var} instead in /home/website/public_html/wp- content/plugins/admin-notices-manager/includes/functions/core.php à la ligne 136<br>
[28-Jul-2024 20:28:17 UTC] PHP Deprecated : Using ${var} in strings is deprecated, use {$var} instead in /home/website/public_html/wp- content/plugins/admin-notices-manager/includes/functions/core.php à la ligne 136<br>
[28-Jul-2024 20:28:17 UTC] PHP Deprecated : Using ${var} in strings is deprecated, use {$var} instead in /home/website/public_html/wp- content/plugins/admin-notices-manager/includes/functions/core.php à la ligne 136

Cette entrée de journal nous indique que le code du plugin utilise une syntaxe PHP obsolète et doit être mis à jour. Vous pouvez suivre les indications du journal pour trouver les fichiers et les lignes de code problématiques et les corriger.

4. installer des plugins pour automatiser les rapports de débogage de WordPress

Si vous ne souhaitez pas vérifier manuellement le journal de débogage à chaque fois, ou si vous voulez un processus de débogage plus rationnel, vous pouvez utiliser certains plugins pour automatiser l'enregistrement et l'affichage du journal de débogage.Moniteur du journal des erreurs est un plugin très simple et efficace qui peut vous aider àConsultez le journal des erreurs directement dans le tableau de bord de WordPress.

Les étapes :

1. Connectez-vous à votre tableau de bord WordPress et accédez à la section plug-in (composant logiciel) -> Ajouter un nouveau plugin.
2. Tapez "Error Log Monitor" dans le champ de recherche et cliquez sur le bouton montage.

3. Une fois l'installation terminée, cliquez sur activer.
4. Dans le tableau de bord "artefact"Sous le menu, vous verrez un nouvel onglet".journal des erreurs", vous pouvez consulter directement le journal des erreurs.
5. Cliquez "configurer"pour personnaliser les paramètres tels que la fréquence des notifications afin de mieux gérer les journaux de débogage.

Ce plugin facilite l'automatisation des rapports de débogage sans avoir à télécharger les fichiers journaux via FTP à chaque fois.

résumés

L'activation du mode de débogage de WordPress et l'utilisation des journaux de débogage constituent une étape importante dans la résolution des problèmes liés au site web. Le débogage est réalisé en créant un journal de débogage dans le fichier wp-config.php permettre WP_DEBUG répondre en chantant WP_DEBUG_LOGvous pouvez enregistrer toutes les erreurs dans un fichier journal afin de pouvoir les consulter et les traiter facilement par la suite. L'utilisation d'un fichier journal tel que le Moniteur du journal des erreurs Les plug-ins peuvent encore simplifier la gestion des journaux, ce qui facilite le suivi de l'état opérationnel de votre site et la résolution rapide des problèmes.