View source for Connecting to an external database

If you need to access tables within the same database as your Joomla! installation then you can simply use the [[JFactory/getDBO|JFactory->getDbo]] method.  This uses the already established connection that Joomla! uses to connect to the database.  For example:

<source lang="php">
<?php
$db = JFactory::getDbo();
?>
</source>

$db is now an object of type [http://api.joomla.org/cms-3/classes/JDatabaseDriver.html JDatabaseDriver] and you can perform database operations on it using the usual methods.

But what if you want to connect to a completely different database from the one used by Joomla!?.  This might be a different database on the same machine as your Joomla! site or it might be on a different host and perhaps even require a different database driver.  Well, you can do this using the [http://api.joomla.org/cms-3/classes/JDatabaseDriver.html#getInstance JDatabaseDriver->getInstance] method.

<source lang="php">
<?php
$option = array(); //prevent problems

$option['driver']   = 'mysql';            // Database driver name
$option['host']     = 'db.myhost.com';    // Database host name
$option['user']     = 'fredbloggs';       // User for database authentication
$option['password'] = 's9(39s£h[%dkFd';   // Password for database authentication
$option['database'] = 'bigdatabase';      // Database name
$option['prefix']   = 'abc_';             // Database prefix (may be empty)

$db = JDatabaseDriver::getInstance( $option );
?>
</source>

$db is now an object of type [http://api.joomla.org/cms-3/classes/JDatabaseDriver.html JDatabaseDriver] and you can perform database operations on it using the usual methods.

Note that if the database uses a non-standard port number then this can be specified by adding it to the end of the host name.  For example, you might have your MySQL database running on port 3307 (the default is port 3306), in which case your host name might be 'db.myhost.com:3307'.

One feature of using [http://api.joomla.org/cms-3/classes/JDatabaseDriver.html#getInstance JDatabaseDriver->getInstance] is that if another call is made with the same parameters it will return the previously created object rather than creating a fresh one.

Note, however, that the parameters must match exactly for this to happen.  For example, if two calls were made to a MySQL database using [http://api.joomla.org/cms-3/classes/JDatabaseDriver.html#getInstance JDatabaseDriver->getInstance], with the first using a host name of 'db.myhost.com' and the second using 'db.myhost.com:3306', then two separate connections would be made, even though port 3306 is the default port for MySQL and so the parameters are logically the same.

If you want to use the JModel with pagination etc. you can choose a different way. The point is, you have to replace the standard database object linked to the Joomla background database using [[JDatabase/setDbo|JDatabase->setDbo]]. The first step is to override the constructor of your JModel in your model file
<source>
public function __construct($config = array())
	 {
		parent::__construct($config);

		$option = array(); //prevent problems
 
		$option['driver']   = 'mysql';            // Database driver name
		$option['host']     = 'localhost';    // Database host name
		$option['user']     = 'myusername';       // User for database authentication
		$option['password'] = 'saltedpassword';   // Password for database authentication
		$option['database'] = 'db_extern';      // Database name
		$option['prefix']   = '';             // Database prefix (may be empty)
		
		$db = JDatabaseDriver::getInstance( $option );
		parent::setDbo($db);
	 }
</source>
After that JModel behaves normal but uses your database.
<noinclude>[[Category:Development]][[Category:Database]][[Category:FAQ]][[Category:Tutorials]]</noinclude>