Public static method of the InvDB singleton object used to get an instance of a database connection object anywhere in the code. $this->inv_db exists in most contollers, so this would normally be used to either obtain an instance of the default database in a supporting class, or for getting a connetion to a different database.
$dbname (STRING) - identifier for a database connection string in your website config.
OBJECT - database connection object
// Gets a database connection object for a database in your config called 'shoedb'
$obj_shoe_db = InvDB::getDatabase('shoedb');
// Gets the default database connection object.
$obj_db = InvDB::getDatabase('default');