/** * This function will return a YDDatabaseDriver instance for the named database instance. If no instance is * given, the one with the name "default" will be used. You can use database instance objects too. * * @param $name (optional) The name or object of the database instance. Defaults to "default". * * @returns An instance of YDDatabaseDriver * * @static */ function getNamedInstance($name = 'default') { // Check if name is a YDDatabaseDriver object if (is_object($name)) { return $name; } // Check if the global array exists YDDatabase::_initNamedInstances(); // Trigger an error if the named instance doesn't exist. if (!array_key_exists(strtolower($name), $GLOBALS['YD_DB_INSTANCES'])) { trigger_error('The named database instance "' . $name . '" is not defined.', YD_ERROR); } // Get the parameters $params = $GLOBALS['YD_DB_INSTANCES'][strtolower($name)]; // Return the right named instance return YDDatabase::getInstance($params[0], $params[1], $params[2], $params[3], $params[4]); }