Malgré la bonne configuration faite sur votre site WordPress, vous n’atteindrez jamais le codage parfait. Eh oui ! Malgré la maniabilité avec laquelle vous pouvez gérer WordPress, quelques erreurs de codes peuvent passer par-dessus votre vigilance. Et vous aurez besoin de déboguer WordPress pour résoudre ce problème. Dans l’écosystème WordPress, les erreurs peuvent survenir à cause d’une mauvaise configuration dans l’arborescence même du logiciel. Mais, la panne peut être aussi provoquée par des plugins ou thèmes en conflit avec le PHP.
Il existe plusieurs manières de faire un débogage dans WordPress. Ainsi, cet article vous donnera en détail, ces moyens de dépannage. En tant que gestionnaire d’un site web basé sur WordPress, vous devez maîtriser ces connaissances. Ce qui vous permettra un jour de corriger une possible erreur survenue sur votre site sans pour autant faire appel à votre hébergeur ou à un développeur.
Désactiver tous les plugins pour déboguer WordPress
Les plugins WordPress permettent d’étendre les fonctionnalités de WordPress. Toutefois, certains peuvent nuire à votre site s’ils sont mal configurés. Vous devez noter que la plupart d’erreurs peuvent être provoquées par un conflit entre vos extensions et votre configuration PHP.
Cela peut être dû à une incompatibilité avec le thème visuel ou une utilisation de versions obsolètes des plugins qui ont alors provoqué un conflit avec le PHP.
Utiliser le WordPress Manager LWS
Pour désactiver un plugin ou un thème, vous pouvez utiliser l’outil WordPress Manager LWS. Il est inclus à tous les packs d’hébergement web WordPress, les formules d’hébergement web mutualisé, mais aussi les plans d’hébergement cPanel. Via l’outil WordPress Manager LWS, vous pouvez désactiver un plugin ou un thème sans même vous connecter au tableau de bord de votre site WordPress !
Utiliser le FTP ou un gestionnaire de fichiers
Vous pouvez également effectuer ces actions via un client FTP ou encore un gestionnaire tel que le File Manager LWS ou le gestionnaire de fichiers cPanel.
Si vous souhaitez utiliser un logiciel client FTP, vous pouvez utiliser FileZilla qui est le logiciel le plus simple à utiliser. Après l’avoir installé sur votre bureau, vous devez vous connecter à votre serveur d’hébergement en utilisant les accès FTP, qui vous ont été envoyés lors de la commande de l’hébergement.
Une fois connecté, rendez-vous dans le dossier « public_html › wp-content ». Tout ce que vous avez à faire est de localiser et renommer le dossier « plugins » en « plugins_old ». Après avoir enregistré, tous vos plugins seront désactivés. Ensuite, vous devez vous connecter à votre espace d’administration. Vous allez constater un message d’erreurs lié à cette désactivation.
Par la suite, vous devez vous connecter à nouveau à votre serveur et renommer le dossier « plugins_old » en « plugins ». Après, vous devez actualiser votre tableau de bord. Vous allez trouver tous les plugins, mais désactivés.
Pour identifier le plugin à conflit, commencez à les réactiver un à un. Vous pouvez aussi désactiver tous les plugins en utilisant le gestionnaire de fichiers intégré à votre compte d’hébergement.
Activer le WP_DEBUG sur WordPress
Lorsque les erreurs de codes surviennent sur WordPress, par défaut, il n’est pas aisé d’identifier leur nature et encore moins leur source. Tout ce que WordPress peut afficher sur votre tableau de bord ou sur votre site est une simple phrase vous indiquant qu’une erreur technique est survenue.
La commande « wp_debug » activée affiche les avertissements, les erreurs ainsi que les notifications liées à la configuration de PHP. Ce qui peut faciliter la correction de l’erreur une fois que le code corrompu a été identifié. En outre, cette commande peut vous permettre de recevoir les notifications en rapport avec la mise à jour de modules et scripts que vous utilisez sur votre installation.
Utiliser le WordPress Manager LWS
L’outil WordPress Manager LWS vous permet d’activer le mode de débogage WordPress en 1 clic. Depuis votre espace client LWS Panel, ou l’outil Softculous dans cPanel, vous pouvez choisir d’activer ou non le mode de débogage.
Modifier le fichier wp-config.php
Vous pouvez utiliser un client FTP pour vous connecter à votre serveur d’hébergement ou utiliser le gestionnaire de fichiers intégré à votre compte pour modifier le fichier « wp-config.php » afin d’activer le mode de débogage.
Ouvrez le fichier « public_html ». Puis, recherchez le fichier « wp-config.php ».
Une fois trouvé, faites un clic droit, par la suite choisissez l’option « Éditer ».
Choisissez le type d’encodage et ouvrez le fichier dans une nouvelle interface. Vous devez vous assurer que la constante est activée. Pour cela, remplacez « false » par « true ».
Une fois cela fait, enregistrez vos modifications. Si cette ligne de codes n’existe pas, vous pouvez l’ajouter manuellement :
define( 'WP_DEBUG', true );
Vous devez également ajouter cette ligne de code au fichier wp-config.php afin de permettre à WordPress d’enregistrer les erreurs dans un fichier que vous pouvez consulter plus tard.
define( 'WP_DEBUG_LOG', true );
Une fois cela fait, les erreurs seront enregistrées dans le fichier « debug.log ». Vous allez retrouver ce fichier dans le dossier « wp-content/debug.log ».
Enfin, pour éviter que les erreurs soient visibles en public par vos visiteurs, ajoutez le code suivant :
define( 'WP_DEBUG_DISPLAY', true );
Activer SAVEQUERIES
La commande SAVEQUERIES permet d’enregistrer toutes les requêtes envoyées à la base de données. Lorsqu’elle est activée, WordPress enregistre automatiquement chaque requête et son temps d’exécution. De plus, vous aurez également les informations sur la fonction ayant appelé chaque requête adressée à la base de données.
Pour l’activer, tout ce que vous avez à faire est d’ajouter la ligne de code suivante à votre fichier « wp-config.php » :
define( 'SAVEQUERIES', true );
Vous devez enregistrer vos modifications afin de les appliquer.
Activer le rapport d’erreurs WPDB
Avec cette astuce, vous pouvez visualiser toutes les erreurs qui surviennent au niveau de la base de données et obtenir une manière pour les résoudre.
Pour activer le rapport d’erreurs WPDB, rendez-vous dans le dossier racine de votre site (public_html). Ensuite, ouvrez « wp-includes › wp-db.php ». Une fois ouvert, vous devez défiler, rechercher la classe « wp-db »
Après l’avoir trouvé, faites un clic droit et choisissez l’option « Éditer ».
Une fois ouvert, vous devez défiler et trouver la variable « $show_errors ».
Par la suite, vous devez vous assurer que sa valeur est définie sur « true ». Une fois terminé, WordPress peut maintenant enregistrer les erreurs liées aux requêtes SQL envoyées à la base de données.
Vérifier les erreurs PHP
PHP est le cœur de WordPress, lorsqu’une erreur survient sur votre site et que vous ne connaissez pas sa source, il est intéressant d’interroger aussi cette partie de votre installation.
Vous pouvez vous servir de cette possibilité que si vous avez activé la journalisation des erreurs WordPress sur votre site.
De cette façon, toutes les erreurs liées à PHP et sa suite sont enregistrées dans le fichier « error_log ». Vous trouverez ce fichier en accédant à votre dossier racine « public_html ». Vous pouvez utiliser un gestionnaire de fichiers ou un client FTP (FileZilla par exemple). Une fois trouvé, faites un clic droit et choisissez l’option « View ».
Une fois cela fait, le fichier sera ouvert dans une nouvelle interface. Vous pouvez maintenant analyser ces relevés avec possibilité de trouver où l’erreur se situe.
Par défaut, WordPress affiche une version minifiée de fichiers CSS et JavaScript pour accélérer le chargement de votre site. Cela peut conduire à masquer certaines erreurs qui surviennent dans cette partie du site, qui peuvent être pourtant fatales.
En activant le SCRIPT_DEBUG dans le fichier wp-config.php, vous forcez WordPress à afficher la version complète de CSS et JS. Ce qui peut vous aider à identifier une possible erreur.
Tout ce que vous avez à faire est d’ajouter la ligne de code suivante à votre fichier de configuration wp-config.php :
define( 'SCRIPT_DEBUG', true );
Une fois cela fait, faites l’enregistrement de vos modifications.
Une fois que avez corrigé l’erreur, il est recommandé de désactiver cette option, car elle peut affecter les performances de votre site. Pour cela, changez la valeur « true » en « false ».
Utiliser Query Monitor pour déboguer WordPress
L’extesion Query Monitor vous permet de déboguer WordPress en analysant plusieurs sections de votre site à la fois. Connectez-vous à votre espace d’administration, recherchez ce plugin et puis passer à installez le plugin.
Une fois installé, le plugin va être accessible à partir de la barre supérieure du tableau de bord.
Après avoir cliqué, une nouvelle interface vous sera présentée, où vous pouvez analyser les erreurs sur votre installation WordPress.
Vous pouvez par ailleurs accéder aux journaux d’erreurs, aux relevés de requêtes, aux crochets et actions, aux appels d’API HTTP…
Trouver l’erreur avec Debug Bar
Debug Bar est un autre plugin qui vous permet d’identifier quelques erreurs survenues sur votre site. Accédez à « Extensions › Ajouter ». Recherchez le plugin et passez à l’installation.
Une fois installé, vous pouvez accéder à l’extension à partir de la barre supérieure de l’espace d’administration.
Après avoir cliqué sur le bouton « Debug », une nouvelle interface vous sera présentée.
Faites l’analyse de requêtes avec possibilité d’identifier l’erreur.
Conclusion
Félicitations ! Vous savez maintenant comment déboguer WordPress !
Le débogage WordPress est un processus incontournable dans la gestion des erreurs de WordPress, il est donc impératif de savoir comment repérer les erreurs afin de procéder à leur résolution rapide.
En cas de besoin, votre hébergeur se tient à votre disposition. LWS met à votre disposition un support technique composé d’une équipe d’experts formés de manière continue, gratuitement et 7j/7 !
Besoin d’un hébergement WordPress rapide et de qualité ?
LWS vous conseille sa formule d’hébergement WordPress en promotion à -20% (offre à partir de 3,99€ par mois au lieu de 4,99 €). Non seulement les performances sont au rendez-vous mais vous profitez en plus d’un support exceptionnel.
Vous avez des questions quant au débogage WordPress ou souhaitez apporter des précisions ? N’hésitez pas à nous contacter via la section commentaires !