Comment déboguer WordPress "Erreur lors de l’établissement de la connexion à la base de données"

WordPress est l’un des systèmes de gestion de contenu open source les plus populaires au monde. Bien que centré au début sur le blogging, il est devenu au fil des années une plate-forme plus flexible pour les sites Web en général. Après presque quinze ans de développement, il est assez poli et robuste, mais des problèmes peuvent encore se poser.

Si vous avez récemment tenté de charger votre site Web utilisant WordPress et que vous voyez à la place un message indiquant «Erreur d’établissement de la connexion à la base de données», la cause en est l’un des suivants:

Examinons ces problèmes un par un pour déterminer s’ils vous affectent et comment les résoudre.

Ce tutoriel suppose ce qui suit:

Une bonne première étape pour déboguer ce problème consiste à essayer de vous connecter au serveur pour voir si le système est en bon état et si MySQL est en cours d’exécution.

Connectez-vous à votre serveur via SSH, en veillant à remplacer les parties en surbrillance ci-dessous par les informations de votre propre utilisateur et du serveur:

Si vous avez besoin d’aide pour vous connecter à votre serveur, veuillez consulter notre article Comment vous connecter à votre Droplet avec SSH.

Maintenant que nous sommes connectés, vérifions que votre serveur MySQL est en cours d’exécution:

La commande + netstat + imprime des informations sur le système de mise en réseau de notre serveur. Dans ce cas, nous voulons que les noms des programmes (+ -p +) écoutent les connexions (+ -l +) sur une socket TCP (+ -t +). Vérifiez la sortie pour une ligne listant + mysqld +, surlignée ci-dessous:

Si votre sortie est similaire, nous savons que MySQL est en cours d’exécution et à l’écoute des connexions. Si vous ne voyez pas MySQL dans la liste, essayez de démarrer MySQL manuellement. Sur la plupart des systèmes, cela ressemble à ceci:

Certaines distributions Linux (CentOS, notamment) utilisent + mysql + au lieu de ‘mysql +’ pour le nom du service. Remplacez le cas échéant.

MySQL devrait commencer. Pour vérifier, relancez la commande + netstat + que nous avons utilisée ci-dessus et vérifiez le résultat du processus + mysqld +.

MySQL et WordPress ont tous deux besoin de beaucoup de mémoire pour fonctionner correctement. Si MySQL s’est arrêté en raison d’une mémoire insuffisante, nous devrions en voir des preuves dans ses journaux d’erreur. Regardons:

+ zgrep + recherchera dans les fichiers journaux, y compris les anciens fichiers journaux archivés sous forme de fichiers compressés + .tar.gz +. Nous recherchons des lignes contenant + allocation de mémoire +, dans tout fichier + error.log * + du répertoire ++.

Si vous voyez une ou plusieurs lignes comme ci-dessus, votre serveur MySQL est à court de mémoire et se ferme. S’il ne s’agit que d’une ligne, il est possible que le trafic soit inhabituel. S’il y a beaucoup de lignes d’erreur, votre serveur est régulièrement contraint par la mémoire. Dans les deux cas, la solution consiste à migrer vers un serveur disposant de plus de mémoire disponible. Sur la plupart des fournisseurs de cloud, il est simple de mettre à niveau un serveur existant avec un temps d’immobilisation minimal.

Si vous ne voyez aucune sortie après avoir exécuté la commande + zgrep +, votre serveur ne manque pas de mémoire. Si votre site génère toujours des erreurs, passez à l’étape suivante. Nous examinerons notre configuration WordPress et nous assurerons que les informations de connexion à MySQL sont correctes.

Si vous venez de déplacer votre installation WordPress entre des serveurs ou des fournisseurs d’hébergement, vous devrez peut-être mettre à jour les informations de connexion de votre base de données. Celles-ci sont stockées sur le serveur dans un fichier PHP appelé + wp-config.php.

Commençons par trouver votre fichier + wp-config.php:

Cela recherche tout dans le répertoire racine (+ / +), et trouve tout fichier nommé + wp-config.php +. Si un tel fichier existe, le chemin complet sera affiché:

Maintenant, utilisez votre éditeur de texte favori pour ouvrir le fichier de configuration. Nous allons utiliser l’éditeur + nano ici:

Cela ouvrira un fichier texte contenant des variables de configuration et du texte explicatif. En haut, vous trouverez les informations de connexion à notre base de données:

wp-config.php

Vérifiez que ces trois variables sont correctes en fonction de vos enregistrements. S’ils ne semblent pas corrects, mettez à jour si nécessaire, sauvegardez et quittez (+ CTRL-O +, puis + CTRL-X + si vous utilisez + nano +). Même si les informations de connexion semblent correctes, essayez de vous connecter à la base de données à partir de la ligne de commande, juste pour vous en assurer. Copiez et collez les détails directement du fichier de configuration dans la commande suivante:

Vous serez invité à entrer un mot de passe. Collez-le et appuyez sur + ENTER. Si vous obtenez une erreur * Accès refusé *, votre nom d’utilisateur ou mot de passe est incorrect. Sinon, la commande + mysqlshow + affichera toutes les bases de données auxquelles l’utilisateur spécifié a accès:

Vérifiez que l’une des bases de données correspond exactement à ce qui se trouve dans votre fichier de configuration WordPress. Si tel est le cas, vous avez vérifié que votre configuration était correcte et que WordPress devrait pouvoir se connecter à la base de données avec succès. Rechargez votre site Web pour voir si l’erreur a disparu.

Ne fonctionne toujours pas? La prochaine chose à faire est de réparer la base de données.

Parfois, en raison d’un échec de la mise à niveau, d’un blocage de la base de données ou d’un plugin défectueux, votre base de données WordPress peut être corrompue. Ce problème peut se présenter comme une erreur de connexion à la base de données. Si votre problème n’est pas lié au serveur MySQL ni au fichier de configuration, essayez de réparer votre base de données.

WordPress fournit un utilitaire intégré pour réparer la base de données. Il est désactivé par défaut, car il ne dispose pas de contrôle d’accès et peut poser un problème de sécurité. Nous allons activer la fonctionnalité, exécuter les réparations, puis la désactiver.

Ouvrez à nouveau le fichier + wp-config.php:

Sur toute ligne vierge, collez ce qui suit:

wp-config.php

Ceci définit une variable que WordPress recherche pour déterminer si elle doit activer la fonctionnalité de réparation.

Enregistrez et fermez le fichier. Basculez sur votre navigateur et chargez l’adresse suivante, en vous assurant de remplacer le domaine ou l’adresse IP de votre site par la partie mise en évidence:

Une page de réparation de base de données va charger:

image: https: //assets.digitalocean.com/articles/wp-database-error/wp-db-repair.png [page de réparation de la base de données WordPress]

Appuyez sur le bouton * Base de données de réparation *. Une page de résultats s’affiche pour vous permettre de voir les vérifications et les réparations en temps réel:

image: https: //assets.digitalocean.com/articles/wp-database-error/wp-db-repair-results.png [Page de résultats de réparation de la base de données WordPress]

Une fois le processus terminé, veillez à ouvrir à nouveau le fichier + wp-config.php + et à supprimer la ligne que nous venons de coller.

Avez-vous remarqué des réparations en cours? Réessayez votre site et vérifiez si l’erreur a disparu. Si des problèmes non réparables sont détectés, vous devrez peut-être restaurer la base de données à partir d’une sauvegarde, le cas échéant. Veuillez consulter notre tutoriel Comment importer et exporter des bases de données dans MySQL pour plus de détails sur comment le faire

Si aucun problème n’a été trouvé avec la base de données, nous n’avons toujours pas découvert le problème. C’est peut-être des problèmes intermittents qui nous manquent ou quelque chose de plus obscur. Permet de conclure avec quelques autres possibilités à essayer.

La majorité des problèmes liés à «Erreur d’établissement de la connexion à la base de données» auraient dû être résolus avec les trois étapes ci-dessus. Néanmoins, il pourrait y avoir des problèmes plus insaisissables qui continuent à se présenter de cette manière. Voici d’autres articles qui pourraient être utiles pour détecter et neutraliser la cause de cette erreur: