Doctrine_manual-1-2-en

Chapter 3: Introduction to Connections 28
// ...
$conn->setOption('username', $user);
$conn->setOption('password', $password);
Lazy Database Connecting
Lazy-connecting to database can save a lot of resources. There might be many times where
you don't need an actual database connection, hence its always recommended to use lazyconnecting
(that means Doctrine will only connect to database when needed).
This feature can be very useful when using for example page caching, hence not actually
needing a database connection on every request. Remember connecting to database is an
expensive operation.
In the example below we will show you when you create a new Doctrine connection, the
connection to the database isn't created until it is actually needed.
Listing
3-11
// bootstrap.php
// ...
// At this point no actual connection to the database is created
$conn = Doctrine_Manager::connection('mysql://username:password@localhost/
test');
// The first time the connection is needed, it is instantiated
// This query triggers the connection to be created
$conn->execute('SHOW TABLES');
Testing your Connection
After reading the previous sections of this chapter, you should now know how to create a
connection. So, lets modify our bootstrap file to include the initialization of a connection. For
this example we will just be using a sqlite memory database but you can use whatever type of
database connection you prefer.
Add your database connection to bootstrap.php and it should look something like the
following:
Listing
3-12
/**
* Bootstrap Doctrine.php, register autoloader and specify
* configuration attributes
*/
require_once('../doctrine/branches/1.0/lib/Doctrine.php');
spl_autoload_register(array('Doctrine', 'autoload'));
$manager = Doctrine_Manager::getInstance();
$conn = Doctrine_Manager::connection('sqlite::memory:', 'doctrine');
To test the connection lets modify our test.php script and perform a small test. Since we
create a variable name $conn, that variable is available to the test script so lets setup a small
test to make sure our connection is working:
First lets create a test table and insert a record:
----------------- Brought to you by