function db_installer_object

Same name in other branches
  1. 7.x includes/install.inc \db_installer_object()
  2. 8.9.x core/includes/install.inc \db_installer_object()
  3. 10 core/includes/install.inc \db_installer_object()

Returns a database installer object.

Before calling this function it is important the database installer object is autoloadable. Database drivers provided by contributed modules are added to the autoloader in drupal_get_database_types() and Settings::initialize().

Parameters

$driver: The name of the driver.

string $namespace: (optional) The database driver namespace.

Return value

\Drupal\Core\Database\Install\Tasks A class defining the requirements and tasks for installing the database.

See also

drupal_get_database_types()

\Drupal\Core\Site\Settings::initialize()

2 calls to db_installer_object()
drupal_get_database_types in core/includes/install.inc
Returns all supported database driver installer objects.
InstallerObjectTest::testDbInstallerObject in core/tests/Drupal/Tests/Core/Database/InstallerObjectTest.php
@dataProvider providerDbInstallerObject

File

core/includes/install.inc, line 1187

Code

function db_installer_object($driver, $namespace = NULL) {
    // We cannot use Database::getConnection->getDriverClass() here, because
    // the connection object is not yet functional.
    if ($namespace) {
        $task_class = $namespace . "\\Install\\Tasks";
        return new $task_class();
    }
    // Old Drupal 8 style contrib namespace.
    $task_class = "Drupal\\Driver\\Database\\{$driver}\\Install\\Tasks";
    if (class_exists($task_class)) {
        return new $task_class();
    }
    else {
        // Core provided driver.
        $task_class = "Drupal\\Core\\Database\\Driver\\{$driver}\\Install\\Tasks";
        return new $task_class();
    }
}

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