Le message d’erreur « Failed to establish a database connection » indique une erreur fatale qui rend votre site WordPress inaccessible aux utilisateurs.
La raison de cette erreur est que WordPress ne peut pas se connecter à la base de données. Dans ce cas, plusieurs variables différentes affectent la connexion entre WordPress et la base de données, ce qui rend le dépannage un peu difficile pour les débutants.
Nous avons préparé une liste des raisons possibles de cette erreur et un guide étape par étape pour remettre votre site WordPress en service le plus rapidement possible.
Contents
- Quelles sont les causes du message d’erreur « Error Establishing a Database Connection » ?
- Vérifiez les identifiants de votre base de données WordPress
- Vérifiez les informations de nom d’hôte de votre base de données
- Réparer les tables de la base de données WordPress
- Vérifiez si le serveur de base de données est hors ligne
- Mettre à jour l’URL du site WordPress
- Redémarrer le serveur web
- Conclusion
- Articles connexes
Quelles sont les causes du message d’erreur « Error Establishing a Database Connection » ?
Le message d’erreur « Error Establishing a Database Connection » peut être dû à des identifiants de base de données incorrects dans vos paramètres WordPress, à une base de données corrompue ou à un serveur de base de données qui ne répond pas.
Qu’est-ce qu’une base de données ?
Pour comprendre le problème, expliquons brièvement à quoi nous avons affaire :
Une base de données est un logiciel qui facilite le stockage, l’organisation et la récupération de données d’un logiciel à un autre.
WordPress agit comme un système de gestion de contenu. Il utilise une base de données pour stocker tout votre contenu et autres données du site. Une connexion à la base de données est établie chaque fois que le site est visité.
Quelles données WordPress nécessite-t-il pour établir une connexion à la base de données ?
WordPress a besoin des informations suivantes :
- Nom de la base de données
- Nom d’utilisateur de la base de données
- Mot de passe de la base de données
- Serveur de la base de données
Ces informations sont enregistrées dans votre fichier de configuration WordPress nommé « wp-config.php ».
Dès que l’un de ces éléments est incorrect, WordPress ne peut plus se connecter à votre serveur de base de données. Vous obtenez alors le message d’erreur « Error Establishing a Database Connection ».
C’est l’une des erreurs WordPress les plus courantes. Outre des identifiants incorrects, cette erreur peut aussi survenir si le serveur de base de données est en panne ou si les fichiers de la base de données sont endommagés.
Diverses raisons peuvent causer cette erreur ; nous avons listé les différents scénarios un par un. Si vous avez déjà essayé l’une de ces approches par vous-même, sélectionnez les étapes suivantes dans la table des matières ci-dessus.
Nous commencerons par la raison la plus probable, puis aborderons des raisons moins courantes.
Vérifiez les identifiants de votre base de données WordPress
La cause la plus fréquente d’échec de connexion à la base de données dans WordPress est l’utilisation d’identifiants de base de données incorrects.
L’une des raisons d’une connexion incorrecte à la base de données WordPress peut être un déplacement récent de votre site WordPress vers un nouvel hébergeur ou serveur.
Les informations de connexion pour la base de données WordPress sont enregistrées dans le fichier wp-config.php. Ce fichier de configuration WordPress contient tous les paramètres WordPress de base, y compris les informations de la base de données.
Connectez-vous à votre site en utilisant un client FTP comme FileZilla et recherchez les lignes ci-dessous dans le fichier wp-config.php :
Vous devez maintenant vous assurer que le nom de la base de données, le nom d’utilisateur et le mot de passe sont corrects.
Vous pouvez vérifier ces informations dans le tableau de bord de votre compte d’hébergement WordPress. Connectez-vous à votre compte d’hébergement et cliquez sur « MySQL Databases » dans la section Base de données.
Vous serez maintenant redirigé vers la page d’administration de la base de données dans votre tableau de bord d’hébergement. Ici, vous pouvez voir votre nom de base de données et votre nom d’utilisateur.
Ci-dessous se trouvent les utilisateurs de la base de données et les liens pour changer le mot de passe utilisateur.
Après avoir vérifié votre nom de base de données, nom d’utilisateur et mot de passe, vous pouvez modifier ces informations dans votre fichier wp-config.php si nécessaire.
Essayez de revisiter votre site pour voir si l’erreur de connexion à la base de données est résolue.
Si vous voyez toujours l’erreur, cela signifie que quelque chose d’autre est en cause. Continuez à lire l’article pour plus d’étapes de dépannage.
Vérifiez les informations de nom d’hôte de votre base de données
Si vous avez suivi la méthode un et vérifié que vous utilisez les bonnes informations de connexion à la base de données WordPress, vous devez vous assurer que vous utilisez les informations de nom d’hôte de base de données appropriées.
La majorité des sociétés d’hébergement WordPress utilisent « localhost » comme hôte de base de données. Cependant, certaines sociétés d’hébergement WordPress utilisent des serveurs séparés pour héberger les bases de données. Dans ce cas, les informations de votre hôte de base de données ne sont pas localhost.
Dans ce cas, vous devrez contacter votre société d’hébergement WordPress pour obtenir les informations de l’hôte de votre base de données.
Réparer les tables de la base de données WordPress
Si vous avez corrigé la première erreur, mais que vous obtenez un autre message d’erreur, « One or more database tables are unavailable, the database may need to be repaired. »
Pour réparer la base de données, ajoutez la ligne suivante au fichier « wp-config.php » :
define('WP_ALLOW_REPAIR', true);
Ajoutez ce texte juste avant la ligne « That’s all, stop editing! Happy blogging ».
Visitez http://www.example.com/wp-admin/maint/repair.php pour voir les paramètres sur cette page :
Cliquez sur le bouton « repair database » et attendez que le processus se termine.
Vérifiez si le serveur de base de données est hors ligne
Si vous avez vérifié tous les éléments et que WordPress ne peut toujours pas se connecter à la base de données, votre serveur de base de données (serveur MySQL) est peut-être en panne.
Cela se produit lorsqu’il y a beaucoup de trafic sur un serveur. Le serveur d’hébergement ne peut pas gérer cette charge importante. Le problème survient particulièrement lorsque vous utilisez un hébergement mutualisé.
En conséquence, votre site deviendra très lent, et certains utilisateurs pourraient même obtenir l’erreur.
Contactez votre hébergeur et vérifiez si votre serveur MySQL répond.
Alternativement, si vous avez d’autres sites web fonctionnant sur le même serveur, vous pouvez vérifier ces sites pour vous assurer que votre serveur SQL est en panne.
Pour vérifier si vos identifiants d’accès à la base de données sont corrects et que votre serveur de base de données n’est pas hors ligne, créez un nouveau fichier texte vide avec un éditeur de texte, nommez-le testconnection.php et copiez-collez le code ci-dessous dans ce fichier texte vide :
<?php $link = mysqli_connect('localhost', 'username', 'password'); if (!$link) { die('Could not connect: ' . mysqli_error()); } echo 'Connected successfully'; mysqli_close($link); ?>
Ajustez les valeurs « username » et « password » selon vos paramètres.
Téléversez maintenant ce fichier via FTP ou un plugin de gestion de fichiers sur votre site et accédez-y via un navigateur web.
Si le script peut se connecter avec succès, cela signifie que votre utilisateur dispose de permissions suffisantes et que votre serveur de base de données est en ligne. Utilisez maintenant les mêmes identifiants dans le wp-config.php, et WordPress pourra se connecter à la base de données.
À l’étape suivante, nous listerons d’autres solutions qui fonctionnent également mais sont moins courantes que les précédentes.
Mettre à jour l’URL du site WordPress
Accédez à phpMyAdmin depuis le tableau de bord de votre compte d’hébergement et sélectionnez votre base de données WordPress.
Puis, cliquez sur le menu SQL en haut et entrez la requête MySQL ci-dessous :
UPDATE wp_options SET option_value='YOUR_SITE_URL' WHERE option_name='siteurl'
Note : Assurez-vous de saisir votre propre « Site URL » et de changer « wp_options » par le nom de la table de votre site si votre site utilise un préfixe de table WordPress différent.
Redémarrer le serveur web
Si vous utilisez un serveur dédié, un serveur local ou un serveur privé virtuel (VPS), vous pouvez essayer de redémarrer vos serveurs.
Redémarrer les serveurs web et de base de données peut résoudre les problèmes temporaires qui pourraient causer l’erreur.
Conclusion
L’« Error Establishing a Database Connection » peut être intimidant, mais avec les bonnes étapes, c’est souvent une réparation simple. En comprenant les causes potentielles et en appliquant les solutions présentées ci-dessus, vous pouvez restaurer rapidement votre site WordPress. Une maintenance régulière et des mesures proactives aideront à prévenir cette erreur à l’avenir.
Articles connexes
