Déboguer un site WordPress : les outils de votre hébergeur et la bonne méthode

Page blanche, « Erreur 500 », « Il y a eu une erreur critique sur ce site », administration inaccessible : la plupart des pannes WordPress viennent d’une extension, du thème ou d’un réglage du serveur. Les outils fournis par votre hébergeur et ceux intégrés à WordPress permettent d’en trouver la cause rapidement. Voici lesquels utiliser et dans quel ordre.

L’essentiel

  • Commencez par lire l’erreur : journal d’erreurs de l’hébergeur ou fichier debug.log de WordPress.
  • N’affichez jamais les erreurs aux visiteurs : enregistrez-les dans un fichier.
  • Testez les corrections sur une copie du site (staging) quand c’est possible.

Les outils de débogage à votre disposition

OutilOù le trouverÀ quoi il sert
Journal d’erreurs du serveurEspace d’hébergement (sur cPanel : « Erreurs » ou fichier error_log dans le dossier du site)Voir les erreurs PHP et serveur avec le fichier et la ligne en cause
Mode débogage de WordPressFichier wp-config.phpEnregistrer les erreurs de WordPress, des extensions et du thème dans wp-content/debug.log
Santé du siteWordPress : Outils › Santé du siteRepérer une version de PHP obsolète, un module manquant, une tâche planifiée en échec
Mode de récupérationE-mail envoyé à l’administrateur après une erreur fataleAccéder à l’administration en désactivant l’extension ou le thème fautif
Environnement de préproduction (staging)Espace d’hébergement, selon l’offreTester une mise à jour ou une correction sans toucher au site en ligne
Sélecteur de version PHPEspace d’hébergementRevenir temporairement à la version précédente après une mise à jour qui casse le site
Outils de développement du navigateurTouche F12 : onglets Console et RéseauRepérer une erreur JavaScript, un fichier introuvable (404) ou une requête bloquée

Activer le mode débogage de WordPress

Dans le fichier wp-config.php (à la racine du site, via le gestionnaire de fichiers de l’hébergeur, SFTP ou l’accès SSH), ajoutez ces lignes avant la ligne « C’est tout, ne touchez pas à ce qui suit » :

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

Les erreurs sont alors écrites dans wp-content/debug.log sans être affichées aux visiteurs. Reproduisez le problème, puis ouvrez ce fichier : la dernière erreur indique généralement le dossier de l’extension ou du thème en cause.

Une fois le problème résolu, remettez WP_DEBUG à false et supprimez debug.log : ce fichier peut être lisible depuis le web et révéler des chemins ou des informations sur votre site.

La méthode pas à pas

  1. Notez ce qui a changé juste avant la panne : mise à jour d’une extension, du thème, de WordPress, de PHP, nouvelle extension, modification de code.
  2. Lisez l’erreur dans le journal du serveur ou debug.log.
  3. Si l’administration est inaccessible, utilisez le lien du mode de récupération reçu par e-mail ; à défaut, renommez le dossier de l’extension suspecte dans wp-content/plugins pour la désactiver.
  4. Isolez la cause : désactivez les extensions une à une (ou toutes, puis réactivez-les une par une) et passez temporairement à un thème par défaut. Faites-le de préférence sur la copie de préproduction.
  5. Vérifiez le serveur : limite de mémoire PHP atteinte (« Allowed memory size exhausted »), espace disque plein, la version de PHP incompatible avec une extension ancienne.
  6. Videz le cache après la correction pour que les visiteurs voient la version réparée.

Les erreurs les plus fréquentes

SymptômeCause probablePiste
« Il y a eu une erreur critique sur ce site »Erreur fatale PHP (extension, thème, code)Mode de récupération, debug.log
Erreur 500Erreur PHP ou fichier .htaccess incorrectJournal du serveur ; renommer temporairement .htaccess puis réenregistrer les permaliens
Page blancheErreur fatale non affichée, mémoire insuffisanteMode débogage, augmenter memory_limit
« Erreur lors de l’établissement de la connexion à la base de données »Identifiants de base erronés ou serveur de base indisponibleVérifier wp-config.php, contacter l’hébergeur
Mise en page cassée, boutons inactifsErreur JavaScript, conflit d’extensions, cacheConsole du navigateur, purge du cache
Erreur 403Pare-feu de l’hébergeur ou extension de sécuritéJournal du pare-feu, liste des IP bloquées

Les extensions utiles

  • Query Monitor : affiche dans la barre d’administration les erreurs PHP, les requêtes lentes à la base de données, les hooks et les scripts chargés. À désactiver une fois le diagnostic terminé.
  • Health Check & Troubleshooting : extension officielle de l’équipe WordPress qui permet de désactiver les extensions et de changer de thème pour vous seul, sans toucher à ce que voient les visiteurs.

Quand contacter l’hébergeur

Si le journal montre une erreur de serveur (base de données indisponible, limite de ressources atteinte, blocage du pare-feu) ou si le site reste en panne alors que toutes les extensions sont désactivées, contactez le support en joignant l’heure de la panne, l’URL et le message d’erreur. La qualité du support et des outils fournis (journaux, staging, sauvegardes, choix de PHP) est un vrai critère de choix : voir notre comparatif des hébergeurs web.

Questions fréquentes

Où se trouve le fichier debug.log ?

Par défaut dans le dossier wp-content, si WP_DEBUG et WP_DEBUG_LOG sont activés.

Le mode débogage ralentit-il le site ?

Légèrement, et il peut exposer des informations : ne le laissez actif que le temps du diagnostic.

Je ne reçois pas l’e-mail du mode de récupération, que faire ?

Désactivez l’extension suspecte en renommant son dossier dans wp-content/plugins par le gestionnaire de fichiers ou en SFTP.

Pour aller plus loin : Créer un site de staging WordPress ; Mettre en place une redirection 301.

Sources

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Défiler vers le haut