Error message

You are browsing documentation for drupal 7.x, which is not supported anymore. Read the updated version of this page for drupal 11.x (the latest version).

function DatabaseTasks::connect

Check if we can connect to the database.

1 call to DatabaseTasks::connect()
DatabaseTasks::runTasks in includes/install.inc
Run database tasks and tests to see if Drupal can run on the database.

File

includes/install.inc, line 431

Class

DatabaseTasks
Database installer structure.

Code

protected function connect() {
 try {
 // This doesn't actually test the connection.
 db_set_active ();
 // Now actually do a check.
 Database ::getConnection ();
 $this->pass ('Drupal can CONNECT to the database ok.');
 } catch (Exception $e) {
 $this->fail (st ('Failed to connect to your database server. The server reports the following message: %error.<ul><li>Is the database server running?</li><li>Does the database exist, and have you entered the correct database name?</li><li>Have you entered the correct username and password?</li><li>Have you entered the correct database hostname?</li></ul>', array(
 '%error' => $e->getMessage(),
 )));
 return FALSE;
 }
 return TRUE;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.