final public static function Database::getConnection
final public static Database::getConnection($target = 'default', $key = NULL)
Gets the connection object for the specified database key and target.
Parameters
$target: The database target name.
$key: The database connection key. Defaults to NULL which means the active key.
Return value
DatabaseConnection The corresponding connection object.
File
- includes/database/database.inc, line 1496
- Core systems for the database layer.
Class
- Database
- Primary front-controller for the database system.
Code
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 self::$connections[$key][$target]; }
© 2001–2016 by the original authors
Licensed under the GNU General Public License, version 2 and later.
Drupal is a registered trademark of Dries Buytaert.
https://api.drupal.org/api/drupal/includes!database!database.inc/function/Database::getConnection/7.x