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:
Error establishing a database connection
Warning: mysql_connect(): Access denied for user: 'user1_name1@localhost' (Using password: YES) in /home/mark123/public_html/catalog/includes/functions/database.php on line 19
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.
Step 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.
1) Create a new database user.
2) Under Add User To Database, choose the user you just created from the User drop-down menu.
3) Choose the name of your database from the Database drop-down menu and click Add.
Note: Be sure to note the database user name and user password for the new user being assigned to the database. This is very essential to the following steps.
Step 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 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/mark123/public_html/catalog/includes/functions/database.php on line 19."
Step 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.
1) Go to the configuration file and choose to Edit.
2) Look in the code for a place where the database name is defined. The database information should be obvious and easy to find. Here is an example of what the database for a WordPress installation would look like:
3) 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:
4) Replace the current DB_USER and DB_PASSWORD values in the file with the new values. For example:
5) Be sure that the host name is localhost.
6) Save the file.
After completing the steps above, you should no longer receive an error message regarding your database connection.