La notification « Erreur lors de l’établissement d’une connexion à la base de données » dans WordPress est une erreur fatale qui rend votre site inaccessible aux utilisateurs/utilisatrices. Elle se produit lorsque WordPress ne parvient pas à se connecter à la base de données.
Étant donné que plusieurs facteurs peuvent affecter cette connexion, l’erreur peut être un peu difficile à dépanner pour les débutants.
Nous gérons notre blog sur WordPress depuis 16 ans et avons rencontré toute une série d’erreurs et d’avertissements, notamment l’erreur d’établissement d’une connexion à la base de données (Error establishing a database connection). Grâce à notre expérience et à de nombreux essais et erreurs, nous avons appris à dépanner ces problèmes sans perturber notre site.
Dans cet article, nous allons vous afficher comment corriger facilement le message » Erreur d’établissement d’une connexion à la base de données » sur votre site WordPress, étape par étape.
Quelle est la cause de l’erreur d’établissement d’une connexion à la base de données dans WordPress ?
Une base de données est un logiciel qui permet de stocker, d’organiser et d’extraire facilement des données d’autres logiciels.
En tant que système de gestion de contenu, WordPress utilise une base de données pour stocker tout votre contenu et les autres données de votre site. Il se connecte ensuite à la base de données chaque fois que quelqu’un visite votre site.
WordPress a besoin des informations suivantes pour se connecter à la base de données :
- Nom de la base de données
- Nom d’utilisateur et mot de passe de la base de données
- Serveur de base de données
Ces informations sont stockées dans votre fichier de configuration WordPress, qui s’appelle wp-config.php.
Si l’une de ces informations est incorrecte, WordPress ne parviendra pas à se connecter à votre serveur de base de données et vous verrez apparaître l’erreur « Erreur dans l’établissement de la connexion à la base de données ».
Il s’agit de l’une des erreurs les plus courantes de WordPress. Outre les informations d’identification incorrectes, cette erreur peut également apparaître si le serveur de données est en panne ou si les fichiers de la base de données sont corrompus.
Ceci étant dit, voyons comment corriger le problème » Erreur lors de l’établissement de la connexion à la base de données » dans WordPress avec un dépannage étape par étape.
1. Vérifiez les infos de la base de données de WordPress
Desinfos connexion incorrectes sont la cause la plus fréquente de l’erreur de connexion à la base de données. Si vous avez récemment déplacé votre site WordPress vers un nouvel hébergeur, c’est probablement la cause du problème.
Les informations d’identification de votre base de données WordPress sont stockées dans le fichier wp-config.php. Il s’agit du fichier de configuration de WordPress qui contient des réglages importants, notamment des informations sur la base de données.
Si vous n’avez jamais modifié un fichier wp-config.php auparavant, consultez notre guide du débutant sur la manière de modifier le fichier wp-config.php pour plus d’instructions.
Vous rechercherez les lignes suivantes dans le fichier wp-config.php :
// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'database_name_here' );
/** MySQL database username */
define( 'DB_USER', 'username_here' );
/** MySQL database password */
define( 'DB_PASSWORD', 'password_here' );
/** MySQL hostname */
define( 'DB_HOST', 'localhost' );
Confirmez ici que les informations relatives au nom de la base de données, à l’identifiant, au mot de passe et à l’hébergeur de la base de données sont correctes.
Vous pouvez confirmer ces informations à partir du tableau de bord de votre compte d’hébergement WordPress. Pour ce tutoriel, nous utiliserons Bluehost, mais le processus sera similaire pour d’autres panneaux d’hébergement également.
Après vous être connecté, cliquez sur l’onglet « Site » dans la colonne de gauche, puis passez à l’onglet « Avancé ». Défilez ensuite jusqu’à la section « Base de données » et cliquez sur le bouton « Gérer » situé à côté.
Cela ouvrira la page des bases de données MySQL dans cPanel dans une nouvelle fenêtre.
Ici, vous pouvez trouver le nom de votre base de données et votre identifiant dans la section » Base de données actuelle « . N’oubliez pas de copier et de coller ces informations dans un bloc-notes afin de les ajouter au fichier wp-config.
Ensuite, défilez jusqu’à la section « Utilisateurs/utilisatrices actuels », où vous pouvez cliquer sur le lien « Modifier le mot de passe » à côté du nom de votre base de données.
Vous accéderez à un nouvel écran, où vous pourrez modifier le mot de passe de la base de données à votre convenance.
Une fois que vous avez confirmé tous les détails de votre base de données, vous pouvez modifier ces informations dans votre fichier wp-config.php si nécessaire.
Après cela, réessayez de visiter votre site pour voir si l’erreur de connexion à la base de données a disparu.
Si l’erreur persiste, cela signifie que quelque chose d’autre ne va pas.
2. Vérifiez les informations relatives à l’hébergeur de votre base de données
Si vous êtes certain que le nom de votre base de données, votre identifiant et votre mot de passe sont corrects, vous devez alors vous assurer que vous utilisez les bonnes informations sur l’hébergeur de la base de données.
La plupart des entreprises d’hébergement WordPress utilisent localhost comme hébergeur de votre base de données. Cependant, certaines entreprises d’hébergement WordPress infogérées utilisent des serveurs distincts pour héberger les bases de données. Dans ce cas, l’hébergeur de votre base de données ne sera pas localhost.
Cela signifie que vous devrez contacter votre entreprise d’hébergement WordPress pour confirmer ces détails.
3. Réparer la base de données de WordPress
Maintenant, il se peut que vous obteniez une erreur différente dans le Tableau de bord wp-admin, comme » Une ou plusieurs tables de la base de données sont indisponibles » ou » La base de données peut avoir besoin d’être réparée « . Dans ce cas, vous devez réparer votre base de données.
Vous pouvez le faire en ajoutant la ligne suivante dans votre fichier wp-config.php. Confirmez-vous que vous l’ajoutez juste avant la ligne « C’est tout, arrêtez les modifications ! Bon blog » :
define('WP_ALLOW_REPAIR', true);
Une fois que vous avez fait cela, vous pouvez voir les réglages en visitant cette page : http://www.yoursite.com/wp-admin/maint/repair.php. Confirmez simplement que vous remplacez yoursite.com par votre propre nom de domaine.
Ici, vous devez cliquer sur le bouton « Réparer la base de données » pour lancer le processus.
Note : L’utilisateur n’a pas besoin d’être connecté pour accéder à la page de réparation de la base de données. Une fois la réparation et l’optimisation de votre base de données terminées, retirez cette ligne de code de votre fichier wp-config.php.
Toutefois, si vous ne souhaitez pas ajouter de code à votre site, vous pouvez également réparer votre base de données à l’aide du cPanel de votre compte d’hébergement.
Rendez-vous sur votre compte hébergeur, où vous devez ouvrir la page ‘Sites Web’ dans la colonne de gauche. Ensuite, passez à l’onglet ‘Avancé’ et cliquez sur le bouton ‘Gérer’ dans la section Base de données.
Cela ouvrira cPanel dans un nouvel onglet. Défilez vers le bas jusqu’à la section ‘Modifier les bases de données’ et choisissez le nom de votre base de données dans le menu déroulant ‘Réparer la base de données’.
Une fois que vous avez fait cela, cliquez simplement sur le bouton « Réparer la base de données » pour lancer le processus.
Le panneau d’hébergement va maintenant réparer automatiquement votre base de données.
Une fois le processus terminé, un message de réussite s’affiche.
Vous pouvez maintenant visiter votre site WordPress pour voir si l’erreur a été résolue ou non.
4. Vérifier si votre serveur de base de données est en panne
Si tout semble correct et que WordPress ne parvient toujours pas à se connecter à la base de données, il se peut que votre serveur de base de données(serveur MySQL) soit en panne.
Cela peut se produire en raison d’un trafic important sur un serveur. Le serveur de votre hébergeur ne peut tout simplement pas supporter la charge (surtout si vous êtes en hébergement partagé).
De ce fait, votre site sera lent et pourra même générer une erreur pour certains utilisateurs/utilisatrices. Dans ce cas, vous devez contacter votre fournisseur d’hébergement par téléphone ou par discussion directe et lui demander si votre serveur MySQL est responsive.
En outre, si d’autres sites fonctionnent sur le même serveur, vous pouvez vérifier ces sites pour confirmer que votre serveur SQL est hors service.
Si vous n’avez pas d’autre site sur le même compte d’hébergeur, il vous suffit de vous rendre sur votre Tableau de bord et de passer à l’onglet « Avancé ».
Cliquez ensuite sur le bouton « Gérer » à côté de la section phpMyAdmin.
Cela ouvrira phpMyAdmin dans une nouvelle fenêtre, où vous devrez cliquer sur l’option « Base de données » en haut.
Cliquez ensuite sur le nom de votre base de données pour accéder à ses Réglages. Si vous y parvenez, il est temps de vérifier si l’utilisateur de votre base de données dispose de droits suffisants.
Pour ce faire, vous devez créer un nouveau fichier appelé testconnection.PHP et y coller le code suivant :
<?php
$link = mysqli_connect('localhost', 'username', 'password');
if (!$link) {
die('Could not connect: ' . mysqli_error());
}
echo 'Connected successfully';
mysqli_close($link);
?>
En collant le code, veillez à remplacer l’identifiant et le mot de passe par les vôtres. Vous pouvez maintenant téléverser ce fichier sur votre site et y accéder via un navigateur web.
Si le script se connecte bien, cela signifie que votre compte dispose de droits suffisants et que l’erreur provient d’une autre source.
Maintenant, vous devez retourner à votre fichier wp-config et l’analyser pour vous assurer que tous les détails sont exacts et sans fautes de frappe.
Autres solutions qui ont fonctionné pour les utilisateurs/utilisatrices
Si les astuces de dépannage mentionnées ci-dessus ne parviennent pas à corriger l’erreur de connexion à la base de données sur votre site, vous pouvez essayer ces étapes supplémentaires.
Comme l’ont signalé nos utilisateurs/utilisatrices, ces étapes ont aidé certains d’entre eux à résoudre l’erreur de connexion à la base de données sur leur site.
1. Mettre à jour l’URL du site WordPress
Vous pouvez essayer de mettre à jour l’URL du site WordPress en utilisant phpMyAdmin dans cPanel.
Il vous suffit d’accéder à phpMyAdmin depuis le tableau de bord de votre compte hébergeur et de sélectionner votre base de données WordPress dans la liste.
Ensuite, passez au menu SQL en haut et saisissez la requête MySQL suivante :
UPDATE wp_options SET option_value='YOUR_SITE_URL' WHERE option_name='siteurl'
Il devrait ressembler à ceci :
N’oubliez pas d’indiquer l’URL de votre site et de modifier wp_options en fonction du nom de votre table, car il se peut que vous ayez modifié le préfixe de la table WordPress.
2. Redémarrage du serveur web
Les utilisateurs/utilisatrices de serveurs dédiés, de serveurs locaux et de serveurs privés virtuels (VPS) peuvent essayer de redémarrer leurs serveurs.
Cette opération redémarre votre serveur web et votre base de données, ce qui peut corriger certains problèmes temporaires à l’origine de l’erreur.
3. Demander de l’aide
Si tout le reste échoue, alors vous devrez peut-être contacter votre entreprise d’hébergement web. Toutes les bonnes entreprises d’hébergement WordPress vous aideront à dépanner le problème, vous indiqueront la bonne direction, voire le corrigeront pour vous.
Vous pouvez également embaucher des développeurs/développeuses WordPress en utilisant une plateforme comme WPBeginner Pro Services pour vous aider à corriger ce problème à des tarifs raisonnables. Nous avons une équipe dédiée de développeurs/développeuses experts à qui vous pouvez faire confiance pour résoudre tous vos problèmes WordPress.
Vous pouvez également faire appel à ce service pour la maintenance de sites, la réparation de sites piratés, l’optimisation de la vitesse, la reconstruction de sites et l’optimisation du référencement.
Nous espérons que cet article vous a aidé à corriger le problème » Erreur d’établissement d’une connexion à la base de données » sur WordPress. Vous pouvez également consulter notre guide de dépannage WordPress pour des conseils sur la résolution des problèmes WordPress par vous-même ou notre module sur la façon d’ajouter une page d’erreur de base de données personnalisée dans WordPress.
Si vous avez aimé cet article, veuillez alors vous abonner à notre chaîne YouTube pour obtenir des tutoriels vidéo sur WordPress. Vous pouvez également nous trouver sur Twitter et Facebook.
Dennis Muthomi
I actually encountered this database connection error just recently when working on a staged WordPress site before going live.
I had just moved a WordPress site from local to a vps. The video tutorial at timestamp 2:53; helped me solve the error
WPBeginner Support
Glad our guide was able to help you
Administrateur
Jiří Vaněk
May I ask what the problem is, if I migrate the database to a new one, edit wp-config.php for the new connection, but wordpress does not connect? In the end, I had to delete the old wp-config and create new ones from the installation package. The only thing I found out was that the key stored in wp-config is probably a problem. Am I encrypting somehow connected to the DB and does it have to be removed from the wp-config file during the migration?
WPBeginner Support
You would want to ensure you have a user on that new database with the correct information that you have in your wp-config for the most common cause for that issue.
Administrateur
Raquel Lynn
Thank you!!! Your YouTube video worked perfectly, I repaired my site : )
WPBeginner Support
Great to hear!
Administrateur
Anoop
When i am importing demo Error establishing a database connection message is showing
WPBeginner Support
The steps in this guide should still be able to assist you and we would recommend reaching out to the support for the demo you are importing and they can look into what could be the root of the problem you are running into.
Administrateur
Eddy
Great video, great tutorial, excellent presentation. thanks a lot.
WPBeginner Support
You’re welcome, glad you liked our content!
Administrateur
Henrik R.
I need to change the password for the MySQL database for security reasons.
Isn’t there a way to login to the WP dashboard and tell WP about the new password, instead of having to change the wp-config.php file?
WPBeginner Support
There is not a simple alternative we would recommend at the moment.
Administrateur
Nwabufor John
I changed my WordPress database username and password would it affect my websites SEO?
WPBeginner Support
No, that should not affect your site’s SEO
Administrateur
Nwabufor John
Thank you, I was scared when it happened
varun kamath
Thank you so much
WPBeginner Support
Glad our guide was helpful
Administrateur
LN
First I would like to say thanks for this guide!
I am having an issue “Error establishing a database connection“ I have checked the wp-config.php and all the database information is correct. I wanted to try step 4 in this guide but I don’t really understand how. I logged in to phpMyAdmin, but not sure what the next step is. Do you have a video for that? I am not a developer just a new WP beginner.
WPBeginner Support
You would want to go to your hosting provider’s dashboard or reach out to your hosting provider and they should be able to assist.
Administrateur
IK
Thanks for this wonderful article. it has really helped me
WPBeginner Support
Glad our guide was helpful
Administrateur
Daniel
I almost have given up after having one issue after the other, till i read this. I had this feeling that « this is it » this is the solution I have been looking for. tried it and it worked perfectly, thanks a lot.
WPBeginner Support
Glad our guide was helpful
Administrateur
Paulo
In my case, as I use digital ocean, I had to restart the DROPLET
WPBeginner Support
Thanks for sharing what worked for you
Administrateur
Hrutik vijay kumthekar
I’m getting this error when entered the URL of my site:
There has been a critical error on your website.
WPBeginner Support
For that issue, you would want to take a look at our article below:
https://www.wpbeginner.com/wp-tutorials/how-to-fix-the-wordpress-white-screen-of-death/
Administrateur
Arunya
Thank you very much This Article really helpful
WPBeginner Support
Glad you found our guide helpful
Administrateur
Sal
running out of space has done this to me a few times!
WPBeginner Support
Thanks for sharing that should someone else run into this issue
Administrateur
jennifer mulder
I am getting this error
Warning: mysqli_real_connect(): (HY000/2002): Connection refused in /home/f5853789/public_html/wp-includes/wp-db.php on line 1635
Connection refused
what do I do
WPBeginner Support
That is a different error, you would want to reach out to your hosting provider for assistance with that specific error.
Administrateur
Tejas Misra
I am a beginner to Wordpress, and I am using MAMP to install Wordpress but I’m still getting this error. My credentials are correct, and none of the steps shown above appeared to work. The database is repaired too. I don’t know what to do.
WPBeginner Support
Following our guide on setting up your site on MAMP below, you may want to ensure you added the correct database prefix.
https://www.wpbeginner.com/wp-tutorials/how-to-install-wordpress-locally-on-mac-using-mamp/
Administrateur
sain
Hi, I have just moved my WordPress site to a new hosting provider via ftp when this error popped up. Is there anything I’m to update after a migration? Thanks
WPBeginner Support
For moving to a new host, you would want to take a look at our article below:
https://www.wpbeginner.com/wp-tutorials/how-to-move-wordpress-to-a-new-host-or-server-with-no-downtime/
Administrateur
KWS Adams
Adding this line « » »define(‘WP_ALLOW_REPAIR’, true); » » helped me get my site back after 14 hours of being down. Thought it was my hosts problem. Thanks for the info.
WPBeginner Support
You’re welcome, glad the recommendation was helpful
Administrateur
Maxine
Thanks! Step 1 worked for me.
WPBeginner Support
You’re welcome, glad our guide was able to help
Administrateur
Zubair Rahman
How to increase the connection limit in the MySQL database? My website is intermittently giving database error as it is exceeding the max connection limit allocated on the server.
WPBeginner Support
You would need to reach out to your hosting provider for changing that and they would be able to assist.
Administrateur
Agung Sudomo
I use google cloud as hosting and encounter this problem. What should I do?
WPBeginner Support
You should still be able to follow the steps in this article
Administrateur
Anita
Thank you so much for this! The solution for me was fixing url in sql. Thank you for the code!
WPBeginner Support
You’re welcome, glad our guide could be helpful
Administrateur
Nimra afridi
I have installed a wordpress . i also make post but sometime it shows me that »please install wordpress ». Why it showing me that?
Thank you.
WPBeginner Support
There are a few possible reasons, you may want to reach out to your hosting provider to ensure there are no hiccups on their end.
Administrateur
alex
my website is hosted on aws and i accessed the MYSQL folder via filezila but i couldn’t find the file that contains database username , password and hostname. is there any specific name of that file?
WPBeginner Support
The file with that information would be your wp-config.php file
Administrateur
Chuck Whelon
Very helpful thank you.
WPBeginner Support
You’re welcome
Administrateur
Deborah N.
Thanks. Adding the repair code to my wp config file worked. I appreciate the article. It was straight forward and easy to follow.
WPBeginner Support
You’re welcome, glad our recommendation was helpful
Administrateur
bloggeryanke
your article was helpful i had changed my database password so it wasnt connecting to my blog properly but all thanks to your article the issue has been fixed
WPBeginner Support
Glad our recommendations could help
Administrateur
Joe Marzi
Thank you for sharing such a nice blog.
It will help the beginners of WordPress who are facing the problem regarding Error Establishing in the database connection. Apart from that, It gives a step by step solution so, every reader can easily solve the problem.
WPBeginner Support
You’re welcome, glad our articles can be helpful
Administrateur
Deepak
Thanks for such amazing information. I really liked your article.
WPBeginner Support
You’re welcome, glad you liked our article
Administrateur
Irwin
I got this error after forcefully shutting my computer. After trying all these suggested methods and failing, I rebooted my computer and the database error was fixed.
You should give it a try too if things go south.
WPBeginner Support
Thanks for sharing the solution that worked for you
Administrateur
Erik
Awesome! Very easy to follow and took minutes to solve.
WPBeginner Support
Glad our guide could be helpful
Administrateur
Bob
Yet again you guys come to my rescue. Fixed in a couple of minutes. Well done.
WPBeginner Support
Glad our guide could help
Administrateur
Nick Aninsley
Thank you so much for sharing this tutorial. Actually, had installed WordPress, it shows me “Error Establishing A Database Connection” and I don’t know what to do. Then I have searched on Google and I found your this article and really it is
very helpful for me and also many people who have no idea about this things. and my site were facing many other problems and only one of them has been solved. Thank for article.
WPBeginner Support
Glad our article could help
Administrateur
Emily
I can’t back up my site or do any of what you suggest, because I cannot get into the administrative section of my blog. I can view it, as a viewer, but I have no access to anything more. I also cannot find anyway to contact people from wordpress! Help!?!!
WPBeginner Support
You should be able to create a manual backup using the method here: https://www.wpbeginner.com/beginners-guide/how-to-make-a-wordpress-database-backup-manually/
If you reach out to your hosting provider they should be able to assist with getting you access back to your site
Administrateur
Waqas Gulzar
Guys,
I have fixed it now for my website
It was due to insufficient PHP memory
I have updated my php.ini to increase the PHP memory
WPBeginner Support
Thanks for sharing the solution that worked for you
Administrateur
pushkar
Hi WAQAS,
can you please advice how you updated my php.ini to increase the PHP memory. My Site is down with the error « Error Establishing A Database Connection” and i suspect it is also to do with memory.
WPBeginner Support
We have a guide you can follow here: https://www.wpbeginner.com/wp-tutorials/fix-wordpress-memory-exhausted-error-increase-php-memory/
Administrateur
ken
I’m on BlueHost and just upgraded to WP 5.2 and got the dreaded error message:
« Your PHP installation appears to be missing the MySQL extension which is required by WordPress. »
I tried with PHP 5.6, 7.0 & 7.1 – all give the same response. Any ideas what I can try? My site is completely blocked by the error.
WPBeginner Support
If you reach out to BlueHost they should be able to resolve that issue for you
Administrateur
ravendra
hello I need your help please help me my website is showing Error establishing a database connection
how can I solve I don’t know please help me
WPBeginner Support
You would want to follow the troubleshooting steps in this article for that error.
Administrateur
Daniel
I had this very same issue while using Xampp. After using the « testconection.php » file and through some further trouble shooting, I discovered that my user account was set to connect to « Any host » and by changing it to « Localhost » the problem was solved. I suspect this error came about when I updated Xampp and recreated the same named user.
WPBeginner Support
Thanks for sharing what worked for you
Administrateur
Della
For my case the correct response was by Daniel.
…I discovered that my user account was set to connect to “Any host” and by changing it to “Localhost” the problem was solved.
Thanks so much!
jason
i am getting this error on my localhost
WPBeginner Support
The methods in this article should be able to help with localhost sites as well as hosted sites.
Administrateur
Dana Jewel
Thanks for the article. Hopefully it will help.
WPBeginner Support
You’re welcome
Administrateur
Cosme Fulanito
After succeed the « Check your Web Host (MySQL Server) » test I change the host from 127.0.01 to localhost on the config.php file.
That worked for me.
WPBeginner Support
Thanks for sharing your solution
Administrateur
Vinay Mourya
hi, it is happening to my WordPress site only sometimes and when I reload the page site starts working again please suggest me a solution, for now, I am using Cloudflare as cdn and wp rocket for caching plugin, the theme is newspaper premium.
WPBeginner Support
If it is intermittent like that, you would want to reach out to your hosting provider and let them know and they should be able to assist.
Administrateur
Erick
This solution helped me a lot. Thanks so much.
WPBeginner Support
You’re welcome
Administrateur
Gee
Same exact error i got “Error establishing a database connection” but not all of the sollution you mentíon helped me.
For me the MySql services was disabled: I went to services and start the MySQL to automatic. The other thing was the » log on » to user was administrator and changed it to the account i created.
Now my wordpress site is working again.
WPBeginner Support
Thanks for sharing your solution to this issue for others
Administrateur
Umar
I have a weird situation is, that the error establishing a database connection is only happening to one post in my blog while other posts are not showing this issue.
rabda
I am receiving this error one time on 3 and not always! I do not understand why and how to solve the problem
WPBeginner Support
You may want to try reaching out to your hosting provider to see if their error logs have information that can help find the root of the issue.
Administrateur
Ryan
thanks so much, worked great, really appreciate how fast and to the point the video was, instead of a 7-10min extended one, boom, stright to the point!
Omar
I fixed it by adding « :3306 » to the mysql adress « localhost » in wp-config
Bob Richardson
Thanks so much for this post. Saved me lots of time troubleshooting. I had changed my database password after a web hack and forgot to change wp-config file. Your instructions are spot on.