How to Fix the Error Establishing a Database Connection in WordPress

Are you seeing the ‘Error establishing a database connection’ notice on your WordPress website? It is a fatal error that makes your WordPress website inaccessible to the users.

This error occurs when WordPress is unable to make a connection to the database. A number of things can affect your WordPress database connection which makes it a bit difficult for beginners to troubleshoot.

In this article, we will show you how to easily fix the error establishing a database connection in WordPress.

What Causes Error Establishing a Database Connection in WordPress?

The ‘Error establishing a database connection’ issue can be caused by incorrect database information in your WordPress settings, corrupt database, or an irresponsive database server.

A database is a software which makes it easy to store, organize, and retrieve data into other software.

As a content management system, WordPress uses a database to store all your content and other website data. It then connects to the database each time someone visits your website.

WordPress needs the following information for connecting to the database

  •  Database name
  •      Database username
  •  Database password
  •  Database server

This information is stored in your WordPress configuration file called wp-config.php.

If any of these items are incorrect, WordPress would fail to connect to your database server, and you’ll see the ‘Error establishing a database connection’ error.

It is one of the most common WordPress errors. Apart from incorrect credentials, this error can also appear if the database server is down, or the database files are corrupt.

Let’s take a look at how to fix error establishing database connection issue in WordPress with step by step troubleshooting.

  1. Check Your WordPress Database Credentials

The most common reason for database connection error in WordPress is incorrect database credentials. If you have recently moved your WordPress site to a new host, then this could be the most likely reason.

Your WordPress database credentials are stored in the wp-config.php file. It is the WordPress configuration file that contains important WordPress settings including database information.

If you have not edited wp-config.php file before, then take a look at our guide on how to edit wp-config.php file in WordPress.

You’ll be looking for the following lines in the wp-config.php file.

// ** 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‘ );

You need to make sure that the information for the database name, username, password, and database host is correct.

You can confirm this information from your WordPress hosting account dashboard. Simply log in to your hosting account and click on MySQL databases under the database section.

This will take you to the database management page in your hosting dashboad. From here, you can find out your database name and the username.

Below that you will find the database users and links to change the user password.

Once you have confirmed your database name, username, and password, you can change that information in your wp-config.php file if needed.

After that, try visiting your website again to see if the database connection error has gone.

If you can still see the error, then this means that something else is wrong. Continue reading for more troubleshooting steps.

2. Check Your Database Host Information

If you are confident that your database name, username, and password information is correct, then you may want to make sure that you are using the correct database host information.

Most WordPress hosting companies use localhost as your database host. However, some managed WordPress hosting companies use separate servers to host databases. In that case, your database host information will not be localhost.

You need to contact your WordPress hosting company to confirm your database host information.

3. Repair WordPress Database

If you are getting a different error on the wp-admin, for instance, something like “One or more database tables are unavailable. The database may need to be repaired”, then you need to repair your database.

You can do this by adding the following line in your wp-config.php file. Make sure to add it just before ‘That’s all, stop editing! Happy blogging’ line wp-config.php.

1 define(‘WP_ALLOW_REPAIR’, true);

Once you have done that, you can see the settings by visiting this page: How to fix wordpress database errors

Note: the user does not need to be logged in to access the database repair page. Once you are done repairing and optimizing your database, make sure to remove this code from your wp-config.php.

4. Check if Your Database Server is Down

 

If everything seems to be correct, and WordPress still cannot connect to the database, then your database server (MySQL server) may be down.

This could happen due to heavy traffic on a server. Basically, your host server just cannot handle the load (especially when you are on shared hosting).

Your site will get really slow and for some users it may even output the error. So the best thing you should do is get on the phone or live chat with your hosting provider and ask them if your MySQL server is responsive.

If you have other websites running on the same server, then you can check those sites to confirm that your SQL server is down.

If you do not have any other site on the same hosting account, then simply go to your hosting dashboard and try to access phpMyAdmin and connect the database.

If you can connect, then we need to verify if your database user has sufficient permission. Create a new file called testconnection.php and paste the following code in it:

 

Make sure to replace the username and password. You can now upload this file to your website and access it via web browser.

If the script connected successfully, then it means that your user has sufficient permission, and there is something else that is wrong.

Go back to your wp-config file to make sure that everything there is correct (re-scan for typos).

Other Solutions That Have Worked for Users

If the above-mentioned troubleshooting tips failed to fix the database connection error on your website, then you may try these additional steps.

Reported by our users, these steps have helped some users resolve the database connection error on their websites.

1. Update WordPress Site URL

Try updating the WordPress site URL using phpMyAdmin. Simply access phpMyAdmin from your hosting account dashboard, and select your WordPress database.

After that click on the SQL menu on the top and enter the following MySQL query.

1 UPDATE wp_options SET option_value=‘YOUR_SITE_URL’ WHERE option_name=’siteurl

2. Rebooting Web Server

Users on dedicated servers, local server, and virtual private servers (VPS) can try rebooting their servers.

This will restart your web and database server which may fix some temporary glitches causing the error.

UFABET says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.
For the reason that the admin of this site is working, no uncertainty very quickly it will be renowned, due to its quality contents.
ufabet911 ทางเข้า says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.
naturally like your web site however you need to take a look at the spelling on several of your posts. A number of them are rife with spelling problems and I find it very bothersome to tell the truth on the other hand I will surely come again again.
biolean reviews says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.
Wow wonderful blog layout How long have you been blogging for you make blogging look easy The overall look of your site is great as well as the content.
How To Become A 1xbet Affiliate Partner Coming From Nepal? – nysaaesports says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.

[…] the years, the 1xbet download (https://rayscoweb.com/) affiliate program – 1xPartners – is continuing to grow into the massive community together […]

temp mail says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.
This site is incredible. The radiant material shows the essayist’s enthusiasm. I’m dumbfounded and envision more such astonishing presents.
Gerardo Levine says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.
Your blog post had me hooked from the first sentence.
Extended Opportunity says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.
He Got 256,354 Free Views With AI… Can you believe it? People spend thousands of dollars to get that kind of result… My friend Kundan just did it for free… He only used his new app… AI ScreenSnap… It’s the world’s first AI app that can generate videos with the power of Video-Exclusive AI Engine… That can edit, record, and generate videos with just a few clicks… with zero experience… Click here now and watch AI ScreenSnap in action https://ext-opp.com/AIScreenSnap
Lot Balonem Cena says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.
What a great post! Your points are well-articulated and backed by solid research. Impressive work!
Extended Opportunity says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.
Hey Guys, Warning: From February 2024, all existing email autoresponders will become obsolete! In fact, if you want to send marketing emails, promotional emails, or any other sort of emails starting in February 2024, you’ll need to comply with Gmail’s and Yahoo’s draconic new directives. They require regular marketers like you and I to setup complex code on sending domains… and existing autoresponders like Aweber and GetResponse are not helping: they’re requesting you do all the work, and their training is filled with complex instructions and flowcharts… How would you like to send unlimited emails at the push of a button all with done-for-you DMARC, DKIM, SPF, custom IPs and dedicated SMTP sending servers? What I mean by all of that tech talk above, is that with ProfitMarc, we give you pre-set, pre-configured, DONE-FOR-YOU email sending addresses you can just load up and mail straight away. We don’t even have any “setup tutorials” like other autoresponders either, because guess what: we already did all the setup for you! All of our built-in sending addresses and servers are already pre-warmed with Gmail and Yahoo and they’re loving us: 99% inbox rate is the average! ⇒ Grab your copy here! ⇒ https://ext-opp.com/ProfitMarc
anti diarrhea for dogs says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.
Hi, I think that I saw you visited my web site, so I came to return the favor. I am attempting to find things to improve my web site! I suppose it’s okay to use some of your ideas!!
heb kerrville says:
Your comment is awaiting moderation. This is a preview; your comment will be visible after it has been approved.
Wonderful beat! I wish to apprentice while you amend your web site, how could I subscribe for a blog web site? The account aided me a good deal. I had been a little bit acquainted with this your broadcast provided bright clear idea.