DrupalAPI.de

1. drupal
   1. drupal7

Gets the connection object for the specified database key and target.

Übergabeparameter

$target The database target name.

$key The database connection key. Defaults to NULL which means the active key.

Rückgabewert

The corresponding connection object.

Verwandte Themen

Database abstraction layer

Allow the use of different database servers using the same code base.

Code

includes/database/database.inc, line 1201

<?php
final public static function getConnection($target = 'default', $key = NULL) {
  if (!isset($key)) {
    // By default, we want the active connection, set in setActiveConnection.
    $key = self::$activeKey;
  }
  // If the requested target does not exist, or if it is ignored, we fall back
  // to the default target. The target is typically either "default" or "slave",
  // indicating to use a slave SQL server if one is available. If it's not
  // available, then the default/master server is the correct server to use.
  if (!empty(self::$ignoreTargets[$key][$target]) || !isset(self::$databaseInfo[$key][$target])) {
    $target = 'default';
  }

  if (!isset(self::$connections[$key][$target])) {
    // If necessary, a new connection is opened.
    self::$connections[$key][$target] = self::openConnection($key, $target);
  }

  return isset(self::$connections[$key][$target]) ? self::$connections[$key][$target] : NULL;
}
?>