It is common for many application to use only one or very few database connections. This class holds a single database connection name or a list of datbases identified by a handle. The database connections can be retrieved from anywhere within your code through the static methods. This eliminates the need to pass the connection handle around.

Typical usage example:

1.  $db = ezcDbFactory::create( $dbparams );
2.  ezcDbInstance::set( $db );
3.  
4.  // ...
5.  
5.  
6.  $db = ezcDbInstance::get();

More complex example, with two connections, having identifiers (for convenience):

 1.  $mydb = ezcDbFactory::create( $mysql_dbparams );
 2.  $pgdb = ezcDbFactory::create( $pgsql_dbparams );
 3.  
 4.  ezcDbInstance::set( $mydb, 'my' );
 5.  ezcDbInstance::set( $pgdb, 'pg' );
 6.  ezcDbInstance::chooseDefault( 'my' );
 7.  
 8.  // ...
 9.  
 9.  
10.  $mydb = ezcDbInstance::get( 'my' ); // returns the mysql instance
11.   $pgdb = ezcDbInstance::get( 'pg' ); // returns the pgsql instance
11.   $mydb = ezcDbInstance::get();  // returns the mysql instance which is default

Sets the database $identifier as default database instance.

To retrieve the default database instance call get() with no parameters..

Returns the database instance $identifier.

If $identifier is ommited the default database instance specified by chooseDefault() is returned.

Resets this object to its initial state.

The list of instances will be emptied and resetDefault() will be called.

Resets the default instance holder.

Adds the database handler $db to the list of known instances.

If $identifier is specified the database instance can be retrieved later using the same identifier.