Troubleshooting MySQL Database Connection Issues
Databases are the driving element of a website. Databases tell a website how to function on a dynamic level, meaning that the information can be smart enough to update without the user directly making those changes if need be. Without a proper connection to an SQL database, a website cannot function and you will likely be met with one of the following warnings:
Unable to connect to database server!
These warnings indicate that the website database now exists in cPanel, but the website cannot communicate with it. This can be corrected by checking each of the connection points between the database and the website as detailed in the steps below.
1. Create and Assign a New Database User
The first step is to create a new user and then assign the user to the database. This is needed to reconfigure your website's database settings.
- Create a new database user.
- Under Add User To Database, choose the user you just created from the User drop-down menu.
- Choose the name of your database from the Database drop-down menu and click Add. (Notice that cPanel will automatically prepend your database name with your cPanel username.)
2. Locate the Database Configuration File
Once you have created a new user and have assigned the user to the database, you will need to locate the database configuration file for the website.
- If you received a general error message like the first example, please refer to the following article for help determining the location of your configuration file:
- If you received a specific error message like the second example, then the location of the error has been provided. In the example above, the message indicates that the error occured "in /home/joe123/public_html/catalog/includes/functions/database.php on line 19."
3. Reconfigure the Database Settings
Once the configuration file has been located, you can reconfigure the database settings for your website. Though every script can vary, the following instructions provide a general walkthrough of how to complete this step.
- Go to the configuration file and choose to Edit.
- Look in the code for a place where the database name is defined. The database information should be fairly obvious and easy to find. Here is an example of what the database for a WordPress installation would look like:
define('DB_NAME', 'user1_wrdp1'); define('DB_USER', 'user1_name1'); define('DB_PASSWORD', '5Jmfde%53L'); define('DB_HOST', 'localhost');
- Make sure that the cPanel username in the first part of the database name is correct. Update the cPanel username (part before the underscore) if needed, but change nothing after the underscore. For example:
- Replace the current DB_USER and DB_PASSWORD values in the file with the new values. For example:
define('DB_USER', 'joe123_gatorboy'); define('DB_PASSWORD', 'nvGHdCC0dCMz');
- Be sure that the host name is localhost.
- Save the file, and you are done!
After completing the steps above, you should no longer receive an error message regarding your database connection.