You are here

final public static function Database::addConnectionInfo in Zircon Profile 8

Same name and namespace in other branches
  1. 8.0 core/lib/Drupal/Core/Database/Database.php \Drupal\Core\Database\Database::addConnectionInfo()

Adds database connection information for a given key/target.

This method allows to add new connections at runtime.

Under normal circumstances the preferred way to specify database credentials is via settings.php. However, this method allows them to be added at arbitrary times, such as during unit tests, when connecting to admin-defined third party databases, etc.

If the given key/target pair already exists, this method will be ignored.

Parameters

string $key: The database key.

string $target: The database target name.

array $info: The database connection information, as defined in settings.php. The structure of this array depends on the database driver it is connecting to.

27 calls to Database::addConnectionInfo()
BrowserTestBase::changeDatabasePrefix in core/modules/simpletest/src/BrowserTestBase.php
Changes the database connection to the prefixed one.
ConnectionTest::testConnectionOptions in core/modules/system/src/Tests/Database/ConnectionTest.php
Tests the connection options of the active database.
ConnectionTest::testConnectionRouting in core/modules/system/src/Tests/Database/ConnectionTest.php
Tests that connections return appropriate connection objects.
ConnectionTest::testConnectionRoutingOverride in core/modules/system/src/Tests/Database/ConnectionTest.php
Tests that connections return appropriate connection objects.
ConnectionUnitTest::addConnection in core/modules/system/src/Tests/Database/ConnectionUnitTest.php
Adds a new database connection info to Database.

... See full list

File

core/lib/Drupal/Core/Database/Database.php, line 256
Contains \Drupal\Core\Database\Database.

Class

Database
Primary front-controller for the database system.

Namespace

Drupal\Core\Database

Code

public static final function addConnectionInfo($key, $target, array $info) {
  if (empty(self::$databaseInfo[$key][$target])) {
    self::$databaseInfo[$key][$target] = self::parseConnectionInfo($info);
  }
}