Doctrine_manual-1-2-en

Chapter 10: Component Overview 163
Connection
Doctrine_Connection is a wrapper for database connection. The connection is typically an
instance of PDO but because of how Doctrine is designed, it is possible to design your own
adapters that mimic the functionality that PDO provides.
The Doctrine_Connection class handles several things:
• Handles database portability things missing from PDO (eg. LIMIT / OFFSET
emulation)
• Keeps track of Doctrine_Table objects
• Keeps track of records
• Keeps track of records that need to be updated / inserted / deleted
• Handles transactions and transaction nesting
• Handles the actual querying of the database in the case of INSERT / UPDATE /
DELETE operations
• Can query the database using DQL. You will learn more about DQL in the DQL
(Doctrine Query Language) (page 120) chapter.
• Optionally validates transactions using Doctrine_Validator and gives full information
of possible errors.
Available Drivers
Doctrine has drivers for every PDO-supported database. The supported databases are:
• FreeTDS / Microsoft SQL Server / Sybase
• Firebird/Interbase 6
• Informix
• Mysql
• Oracle
• Odbc
• PostgreSQL
• Sqlite
Creating Connections
// bootstrap.php
Listing
10-4
// ...
$conn = Doctrine_Manager::connection('mysql://username:password@localhost/
test', 'connection 1');
We have already created a new connection in the previous chapters. You can skip the
above step and use the connection we've already created. You can retrieve it by using the
Doctrine_Manager::connection() method.
Flushing the Connection
When you create new User records you can flush the connection and save all un-saved
objects for that connection. Below is an example:
// test.php
Listing
10-5
// ...
----------------- Brought to you by