YII 类库手册

CDbConnection代表一个到数据库的连接。

CDbConnection与CDbCommand, CDbDataReader 和 CDbTransaction一起提供了根据 DBMS 通用 API 来访问数据功能。 它们是PDO PHP 扩展的简化。

要建立一个连接，在指定connectionString, username 和 password之后， 设置active为true，。

下面的例子显示了怎样创建一个CDbConnection实例和建立实际的连接： :

$connection=new CDbConnection($dsn,$username,$password);
$connection->active=true;

在DB连接建立之后，可以执行一个像下面这样的 SQL 语句：

$command=$connection->createCommand($sqlStatement);
$command->execute();   // a non-query SQL statement execution
// or execute an SQL query and fetch the result set
$reader=$command->query();

// each $row is an array representing a row of data
foreach($reader as $row) ...

也能执行一个准备好的 SQL 语句，并绑定参数到准备好的 SQL:

$command=$connection->createCommand($sqlStatement);
$command->bindParam($name1,$value1);
$command->bindParam($name2,$value2);
$command->execute();

要使用事务，像下面这样做：

$transaction=$connection->beginTransaction();
try
{
   $connection->createCommand($sql1)->execute();
   $connection->createCommand($sql2)->execute();
   //.... other SQL executions
   $transaction->commit();
}
catch(Exception $e)
{
   $transaction->rollBack();
}

CDbConnection也提供一套方法来支持设置和查询特定的DBMS属性， 例如 nullConversion。

因为CDbConnection实现了IApplicationComponent接口，它能被用作一个应用程序组件， 并在应用程序中进行配置。 如下：

array(
    'components'=>array(
        'db'=>array(
            'class'=>'CDbConnection',
            'connectionString'=>'sqlite:path/to/dbfile',
        ),
    ),
)