Are you experiencing the Error establishing a database connection error on your WordPress website? This fatal error can make your website entirely inaccessible to users – so, in this knowledgebase article, we’ll walk you through exactly what to do when you experience this issue.
All the information on your website is stored in your database except for the media content. When a user visits your website, PHP executes the code and queries the information from the database, and is then displayed to the user in their browser.
However, if this isn’t working properly then you get the error establishing a database connection. The entire screen is left in a blank state as no data can be retrieved due to loss of connection to the database.
Let’s look at the potential causes of this error:
Database Connection Issues – Potential Causes
- One of the most common reasons is that your database login credentials are incorrect. Your WordPress website uses different login information to connect to its database.
- Your database is corrupted. The database gets corrupted due to a missing or corrupted table. This can also occur when some data is accidentally deleted.
- Issues with your database server. A number of things could be wrong on the web host’s end. This is common in shared hosting as it utilizes the same resources for a lot of users on the same servers.
How to Fix the Error Establishing a Database Connection
1 Check Your Database Login Credentials
This is the most common reason for this error. Hence please check the connection details for your WordPress site stored in the wp-config.php file which is generally located at the root of your WordPress site.
2 Repairing Corrupt Database
There are chances that your database might have been corrupted. This occurs when very often when the tables are added or removed by new plugins or themes. You can check our troubleshooting guide and solve this error.
3 Issues With Your Database Server
If none of the above has helped resolve your issue, then we highly recommend checking with your hosting provider as it could be an issue with your database server. The hosting provider can further assist you to solve this error.
Note: Before you start troubleshooting the error, we always recommend taking a backup. You can always restore your site from a backup if needed.
4 Restore Latest Backup
You should always have a backup in place to avoid losing any data, and it might be a faster way to resolve the issue if you aren’t concerned about losing any data in between the last time you made a backup. Make sure that you have taken a backup of all databases. That way, if something goes wrong, you can restore a working copy of the site instead of losing everything. Many hosting providers have got an option to restore. But you can also use the wp plugin for backup or copy the theme files.
5 Corrupted Plugin or Themes
It is possible that your WordPress files may go corrupted due to an out-of-date plugin or theme that is installed on your website. This could have likely got failed during an update or when attempting to reach an external server. You can solve this issue by identifying and deactivating the corrupted plugin or theme.
That’s it! We hope that this guide helps you in fixing the error in establishing a database connection in WordPress. If this does not solve your issues, please don’t hesitate to contact our support team. We are always available to help you anytime.