function TestDatabase::getConnection
Same name in other branches
- 8.9.x core/lib/Drupal/Core/Test/TestDatabase.php \Drupal\Core\Test\TestDatabase::getConnection()
Returns the database connection to the site running Simpletest.
Return value
\Drupal\Core\Database\Connection The database connection to use for inserting assertions.
See also
\Drupal\simpletest\TestBase::prepareEnvironment()
3 calls to TestDatabase::getConnection()
- simpletest_uninstall in core/
modules/ simpletest/ simpletest.install - Implements hook_uninstall().
- TestDatabase::lastTestGet in core/
lib/ Drupal/ Core/ Test/ TestDatabase.php - Get information about the last test that ran given a test ID.
- TestSetupTrait::getDatabaseConnection in core/
lib/ Drupal/ Core/ Test/ TestSetupTrait.php - Returns the database connection to the site running Simpletest.
File
-
core/
lib/ Drupal/ Core/ Test/ TestDatabase.php, line 39
Class
- TestDatabase
- Provides helper methods for interacting with the fixture database.
Namespace
Drupal\Core\TestCode
public static function getConnection() {
// Check whether there is a test runner connection.
// @see run-tests.sh
// @todo Convert Simpletest UI runner to create + use this connection, too.
try {
$connection = Database::getConnection('default', 'test-runner');
} catch (ConnectionNotDefinedException $e) {
// Check whether there is a backup of the original default connection.
// @see TestBase::prepareEnvironment()
try {
$connection = Database::getConnection('default', 'simpletest_original_default');
} catch (ConnectionNotDefinedException $e) {
// If TestBase::prepareEnvironment() or TestBase::restoreEnvironment()
// failed, the test-specific database connection does not exist
// yet/anymore, so fall back to the default of the (UI) test runner.
$connection = Database::getConnection('default', 'default');
}
}
return $connection;
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.