Comment réparer "Erreur lors de l'établissement d'une connexion à la base de données"

Oh la redoutable "Erreur lors de l'établissement d'une connexion à la base de données", dum, dum, dum (imaginez une musique inquiétante). Si vous êtes un concepteur ou un développeur WordPress chevronné, vous pouvez probablement vous lancer directement dans la correction de cette erreur. Mais pour ceux d'entre vous qui découvrent WordPress, cela peut être un message d'erreur effrayant.

Vous pouvez voir cette erreur lorsque vous essayez d'installer WordPress manuellement ou vous verrez cette erreur en gros caractères noirs sur un écran blanc dans votre navigateur lorsque vous essayez d'ouvrir votre site Web ou votre environnement de développement local. Cette dernière est la version la plus effrayante de cette erreur car elle vous prend généralement au dépourvu.

Bien sûr, tout bon hébergeur WordPress géré devrait tout configurer pour vous et s'assurer que ces erreurs ne se produisent jamais. Mais si vous utilisez un hébergeur WordPress qui vous oblige à installer et à gérer WordPress vous-même, ou si vous développez sur votre ordinateur local, vous pouvez rencontrer ce problème.

De tous les fichiers PHP WordPress nécessaires pour faire fonctionner WordPress, wp-config.php est le plus important car sans ce fichier, votre site ne peut pas se connecter à sa base de données et votre site ne fonctionnera pas. Ce fichier est l'endroit où vous définissez vos informations de connexion à la base de données telles que le nom de la base de données, le nom d'utilisateur, le mot de passe et l'hôte. Sur des hôtes comme Flywheel, vous n'êtes pas en mesure de modifier ce fichier, car il est configuré pour vous. Vous pouvez ignorer cette raison suivante en toute sécurité si vous utilisez un hôte géré.

La raison la plus courante de cette erreur

La raison la plus courante pour laquelle vous obtenez la tristement célèbre "Erreur lors de l'établissement d'une connexion à la base de données" est due à des paramètres de connexion à la base de données incorrects dans wp-config.php . Lorsque vous déplacez un site d'une ancienne société d'hébergement, vous devez vous assurer de mettre à jour le nom de la base de données, le nom d'utilisateur de la base de données et le mot de passe de la base de données dans votre fichier wp-config.php pour refléter la nouvelle base de données sur votre nouvel hébergement.

Déplacement incorrect de votre site WordPress

Un problème courant que j'ai vu est lorsque quelqu'un déplace ses fichiers WordPress vers une nouvelle société d'hébergement, puis pointe le nom de domaine vers le nouvel hôte, mais qu'il n'a pas déplacé sa base de données.

Rendre votre site ultra-rapide : Partie 2

La semaine dernière, j'ai expliqué comment accélérer votre site en mettant l'accent sur les performances frontales. Et bien que cela puisse être extrêmement utile pour accélérer votre site, n'oubliez pas - il y a le dos - ...

Le site s'affichera toujours lorsque vous accéderez à l'URL et le site fonctionnera toujours. Le problème ici est que lorsque vous annulez finalement votre ancien hébergement, le site Web s'arrêtera parce que vous vous connectiez à la base de données sur l'ancien compte d'hébergement, produisant ainsi le message d'erreur "Erreur lors de l'établissement d'une connexion à la base de données".

La meilleure pratique consiste à tout déplacer vers votre nouvelle société d'hébergement et à mettre à jour votre fichier wp-config.php pour refléter la nouvelle base de données. De cette façon, vous pouvez annuler en toute confiance votre ancien compte d'hébergement sans perdre de données et sans voir l'erreur redoutée "Erreur lors de l'établissement d'une connexion à la base de données".

Si vous êtes sur Flywheel, ils se contenteront de tout déplacer pour vous et de s'assurer que vous êtes opérationnel, ce qui vous évite d'avoir à comprendre l'une de ces configurations.

Votre fichier wp-config.php est le premier endroit où vous devez commencer lorsque vous essayez de résoudre ce problème. Si vous vérifiez que vos informations de connexion sont effectivement correctes, passez aux autres correctifs décrits ci-dessous.

Il peut y avoir une variété de raisons pour lesquelles cette erreur se produit et je vais vous guider à travers quelques scénarios supplémentaires. Ne vous inquiétez pas, vous n'avez pas besoin d'être un assistant développeur pour corriger cette erreur.

Avant d'essayer l'un des correctifs ci-dessous, assurez-vous de créer une sauvegarde de votre base de données. Vous pouvez le faire via votre panneau de contrôle d'hébergement en allant sur phpMyAdmin puis en exportant le fichier SQL.

Plongeons-nous ?

Cause 1. Vous avez oublié de mettre à jour votre fichier wp-config.php lorsque vous avez changé le mot de passe de la base de données

Mettre à jour un mot de passe de base de données pour que votre base de données soit plus sécurisée est une très bonne chose à faire. Un mot de passe fort est le meilleur type de mot de passe. N'oubliez pas que lorsque vous modifiez le mot de passe d'une base de données dans votre panneau de contrôle d'hébergement, vous devez également modifier le mot de passe dans votre fichier wp-config.php .

La bonne nouvelle est qu'il s'agit d'une solution facile. Tout ce que vous avez à faire est d'ouvrir votre fichier wp-config.php et d'ajouter le nouveau mot de passe.

Téléchargez votre fichier wp-config.php , ouvrez un éditeur de texte et modifiez la ligne suivante :

define('DB_PASSWORD', 'password-goes-here');

Ajoutez votre nouveau mot de passe, enregistrez le fichier wp-config.php et téléchargez-le via FTP. Actualisez votre site et voyez si votre site revient. Si oui, vous avez terminé. Félicitations – vous gagnez tous les points Internet !

Remarque : Assurez-vous de laisser les guillemets simples autour du mot de passe, et il ne doit pas y avoir d'espace entre les guillemets simples et votre mot de passe non plus.

Facile, non ?

Essentiellement, vous vous assurez que vos informations de connexion à la base de données sont mises à jour pour refléter le nouveau mot de passe de la base de données.

Encore une fois, si vous êtes sur un hébergeur comme Flywheel, cette étape ne vous concerne pas et vous pouvez passer à autre chose en toute sécurité !

Cause 2. Vous avez mal saisi les informations de votre base de données lors de la fameuse « installation en 5 minutes » de WordPress

Les fautes de frappe sont littéralement le fléau de notre existence lorsque nous travaillons en ligne ; une petite faute de frappe peut planter un site Web et dans ce cas, le mauvais trait de soulignement ou l'oubli d'une lettre ou d'un numéro du nom de la base de données, du nom d'utilisateur ou du mot de passe a le même effet de plantage.

La plupart des installations de WordPress sont gérées via votre panneau de contrôle d'hébergement à l'aide d'un assistant de nos jours, ou entièrement effectuées pour vous sur Managed WordPress. Mais certaines personnes aiment installer manuellement. J'entends que les installations manuelles sont toujours une chose.

Si vous avez choisi d'installer WordPress à la manière Ye Olde Fashioned en créant manuellement une base de données et en téléchargeant manuellement le logiciel WordPress via FTP, vous devez vous assurer d'enregistrer les informations de l'utilisateur de la base de données lorsque vous avez créé votre base de données. C'est là que le copier-coller devient vraiment pratique.

Cependant, assurez-vous que lorsque vous copiez ces informations, vous ne copiez que le texte dont vous avez besoin. Saviez-vous que copier un espace supplémentaire après le nom de la base de données, le nom d'utilisateur ou le mot de passe sera lu comme un caractère ? Ce caractère blanc supplémentaire vous donnera des erreurs lorsque le programme d'installation tentera de se connecter à votre base de données.

Assurez-vous également que vous entrez les informations dans le champ approprié lors de l'installation. En fait, j'ai eu un pet cérébral une fois et j'ai réalisé que j'entrais le nom de la base de données dans le mauvais champ. Une fois réparé, l'installation s'est déroulée sans encombre !

Cause 3. Lors du déplacement d'un site Web WordPress vers un nouvel hôte, DB_HOST peut être quelque chose d'unique pour cet hôte

Même si vous avez mis à jour votre fichier wp-config.php pour refléter les nouvelles informations de connexion à la base de données de votre nouvelle société d'hébergement, vous devrez peut-être modifier votre champ DB_HOST .

Ce problème est plus rare, mais cela arrive. Certaines sociétés d'hébergement utilisent leurs propres valeurs uniques lors de la définition du paramètre DB_Host dans wp-config , mais ce n'est pas toujours le cas. D'autres hôtes définissent en fait une URL vers le serveur de base de données MySQL et cela doit être reflété comme valeur pour DB_HOST . Certains utilisateurs ont également réussi à utiliser leur adresse IP d'hébergement à la place d'une URL MySQL ou d'un hôte local, vous pouvez donc également essayer cela.

Si vous êtes sur Flywheel, cela est automatiquement géré pour vous, vous n'avez donc pas à vous inquiéter du tout.

Cause 4. Votre base de données est corrompue

Cette erreur n'est pas la même que "Erreur lors de l'établissement d'une connexion à la base de données", mais elle est légèrement liée. Parfois, le front-end de votre site Web fonctionne correctement, mais vous obtenez une erreur telle que « Une ou plusieurs tables de base de données ne sont pas disponibles, la base de données doit peut-être être réparée » sur le back-end. Cela signifie que vous devez réparer la base de données.

Voici le correctif pour cette erreur :

Ouvrez votre fichier wp-config.php et accédez à la section qui définit le nom, le nom d'utilisateur, le mot de passe et l'hôte de votre base de données. Sous Hôte, définissez les éléments suivants :

define('WP_ALLOW_REPAIR', true);

Enregistrez ensuite votre fichier wp-config.php , téléchargez-le via FTP, puis accédez à cette URL :

Cela affichera une page avec deux options. La première option est un bouton qui dit "Réparer la base de données" et la deuxième option est un bouton qui dit "Réparer et optimiser la base de données"

Je dois réitérer l'importance de sauvegarder votre base de données avant de faire cette étape. Même si vous ne pouvez pas vous connecter, cela ne signifie pas que vous ne devriez pas avoir de sauvegarde.

Cliquez sur l'option "Réparer la base de données" et une fois le processus de réparation terminé, ouvrez un nouvel onglet et accédez à votre URL et voyez si le message "Erreur lors de l'établissement d'une connexion à la base de données" a disparu et si votre site est revenu à la normale.

Si ce correctif ne fonctionne pas et que les correctifs ci-dessus ne fonctionnent pas, il y a une dernière cause que vous devez connaître.

La plupart des hôtes gérés sauvegardent vos données quotidiennement pour vous, donc si ce scénario pas si génial se produit, il est parfois simplement plus facile de restaurer à partir de la sauvegarde d'hier et de continuer à avancer.

Cause 5. Le serveur de base de données MySQL est en panne.

Cela a tendance à se produire pour les personnes qui poussent leur hébergement mutualisé à ses limites. Si votre site Web reçoit beaucoup de trafic, cela peut simplement submerger le serveur de base de données. Félicitations à vous pour avoir un site Web qui reçoit tout ce trafic, mais si vous obtenez le message "Erreur lors de l'établissement d'une connexion à la base de données" et que vous avez essayé les autres correctifs, vous devrez peut-être effectuer une mise à niveau.

Sur un hébergeur partagé, des tonnes de sites Web peuvent être entassés sur le même serveur. Si l'on reçoit beaucoup de trafic ou que l'on est simplement un voisin bruyant en général, cela peut causer un énorme problème pour le reste des sites. Sur les hôtes gérés comme Flywheel, chaque site dispose de son propre serveur, ce problème est donc facilement géré.

Mais avant de vous lancer directement dans une mise à niveau d'hébergement, vous devez appeler votre société d'hébergement et lui demander de vérifier l'état du serveur de base de données. Il y a peut-être un problème technique, ou peut-être que votre hébergeur vous a envoyé un e-mail concernant la maintenance planifiée du serveur et que vous avez manqué cet e-mail. Bien qu'il soit hautement improbable que vous voyiez le message "Erreur lors de l'établissement d'une connexion à la base de données" résultant de la maintenance du serveur, j'ai vu qu'une fois dans ma carrière et de toute façon, cela vaut la peine d'appeler pour le savoir.

Parlez à votre hébergeur et expliquez que vous avez essayé ces différents correctifs en vain et demandez-leur de se pencher sur la question. S'ils vous disent que votre site génère une charge importante sur le serveur et recommandent une mise à niveau de l'hébergement, félicitations, vous êtes génial ! N'oubliez pas que ces mises à jour signifient que votre site donne des coups de pied !

La conclusion

Comme vous pouvez le constater, la correction de l'erreur "Erreur lors de l'établissement de la connexion à la base de données" n'est pas aussi effrayante que vous le pensiez. Il suffit d'un peu de diligence raisonnable pour vérifier que vous définissez les paramètres de base de données appropriés dans votre fichier wp-config.php . Dans certains cas, il faut creuser plus profondément pour résoudre le problème. Et à la fin de la journée, votre hébergeur est là pour vous soutenir.

En savoir plus sur le volant d'inertie

Quel que soit votre environnement de travail, la puissante plate-forme WordPress de Flywheel supprime tous les tracas liés à l'hébergement, rationalise vos processus et vous permet de recommencer à faire votre meilleur travail.

En savoir plus ici.