CDbConnection

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

$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) ...

$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();
}

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

属性详细

返回DB连接是否已经建立。

返回先前为数据库连接显式设置的属性。

返回是否创建或更新数据库记录将自动提交。 某些 DBMS (如 sqlite) 可能不支持这个特征。

数据库是否应自动建立连接 此组件将被初始化。默认为true。注意，这个属性仅仅有效果当 CDbConnection对象被用作一个应用程序组件。

用于数据库连接charset字符串。这个属性仅仅用于 MySQL 和 PostgreSQL 数据库。默认为 null, 意味着使用此数据库指定的默认的charset。

注意如果你使用 GBK 或 BIG5 ，那么推荐更新到 PHP 5.3.6+和通过DSN指定 charset 像下面这样 'mysql:dbname=mydatabase;host=127.0.0.1;charset=GBK;'。

返回数据库驱动程序的版本信息。

返回列名称的大小写情况

返回为当前DB连接的SQL命令生成器。

返回连接的状态。 一些 DBMS (如 sqlite) 可能不支持这个特征。

数据源名称或 DSN，包含连接到数据库所需的信息。

返回当前活动的事务。

PDO驱动程序和schema类名之间的映射。 使用路径别名指定一个 schema 类。

返回的数据库驱动程序的名称。

是否打开准备模拟。默认为 false， 意味着PDO将准备使用本地预备支持，如果可用。对于某些数据库 (如 MySQL), 这将需要设置为true 以至于 PDO 能模拟该预备支持 绕过buggy本地预备支持。注意，这个属性仅仅在PHP 5.1.3及以上有效。 默认值为 null，这将不改变PDO的 ATTR_EMULATE_PREPARES 值。

是否记录的值绑定到一个准备的SQL语句。 默认为 false。在开发阶段，你应该考虑设置这个属性为true 以至于参数值能被绑定到SQL语句以记录用于高度目的。 你应该知道记录参数值代价是高昂的， 将很大程度影响你的应用程序的性能。

正在执行的SQL语句是否启用分析。 默认为 false。这个主要 启用它主要用于开发阶段找出SQL执行的瓶颈。

DB连接建立后执行的SQL语句列表。

返回最后一个插入的行的ID或序列值。

返回null与empty字符串如何转化的情况。

建立数据连接的密码。默认为空字符串。

自定义PDO封装类。

返回PDO实例。

返回数据库连接是否持久的。 某些 DBMS (如 sqlite) 可能不支持这个特征。

返回数据库连接是否可执行数据预获取。

缓存应用程序组件的ID，用于查询缓存。 默认为'cache'，它指的是主缓存应用程序组件。 设置这个属性为false，如果你想禁用查询缓存。

下次将被缓存的SQL语句的数目。 如果它是 0，即使查询缓存被启用，查询也不会被缓存。 注意每次执行一条SQL语句之后 (是否在DB服务器上执行或从查询缓存中获取)， 这个属性将被减少1至0。

当查询结果保存到缓存时，使用的依赖。

查询结果被保留在缓存中有效的秒数。 使用0或负数值指示不缓存查询结果 (默认 behavior).

为了启用查询缓存，这个属性必须被设置为正数。 并且 queryCacheID 必须指向一个有效的缓存组件 ID。

该方法cache() 提供一种方便的方法设置此属性 和 queryCachingDependency。

返回当前连接的数据库结构

缓存应用程序组件的ID，用于缓存表的元数据。 默认为'cache' 它指的是主缓存应用程序组件。 如果要禁用缓存表的元数据，此属性设置为false。

数据表中元数据在缓存中保存的秒钟数。 使用0或负值指示不缓存schema。 如果大于0和正数，cache被启用，表的元数据将被缓存。

元数据不被缓存的列的列表。默认为空字符串。

返回DBMS服务器的信息。

返回DBMS服务器的版本信息。

返回SQL执行的统计结果。 返回的结果包含执行SQL语句的数目和 所花费的总时间。 为了使用此方法，enableProfiling必须设置为 true。

表名称的默认前缀。默认为 null，意味着没有表前缀。 通过设置这个属性，任何标记像 '{{tableName}}' 在 CDbCommand::text 将 'prefixTableName'替换， 这里 'prefix' 指的是这个属性值。

返回连接的超时设置。

建立数据连接的用户名。默认为空字符串。

方法详细

构造函数。 注意，当连接实例创建的时候，并不会连接数据库。 设置 active 属性为true， 来建立此连接。

序列化时关闭连接。

启动事务。

设置关于查询缓存的参数。 此方法可用于启用或禁用查询缓存。 通过设置$duration参数为0，查询缓存将被禁用。 要不然， 新的SQL语句执行的查询结果将被保存在缓存中， 并且在指定时间段内有效。 如果同样的查询再次执行，结果将直接从缓存中读取， 而不是执行实际的SQL语句。

关闭当前连接的数据库连接。 如果连接已经关闭，它不执行任何操作。

创建用于执行的命令。

创建一个 PDO 实例。 pdo驱动程序中缺少某些功能时， 我们可以使用一个适配器类，以提供它们。

返回DB连接是否已经建立。

获取指定的数据库连接属性信息。

返回先前为数据库连接显式设置的属性。

返回是否创建或更新数据库记录将自动提交。 某些 DBMS (如 sqlite) 可能不支持这个特征。

返回一个可用的PDO驱动程序的列表。

返回数据库驱动程序的版本信息。

返回列名称的大小写情况

返回为当前DB连接的SQL命令生成器。

返回连接的状态。 一些 DBMS (如 sqlite) 可能不支持这个特征。

返回当前活动的事务。

返回的数据库驱动程序的名称。

返回最后一个插入的行的ID或序列值。

返回null与empty字符串如何转化的情况。

返回PDO实例。

指定的PHP数据类型决定PDO数据类型。

返回数据库连接是否持久的。 某些 DBMS (如 sqlite) 可能不支持这个特征。

返回数据库连接是否可执行数据预获取。

返回当前连接的数据库结构

返回DBMS服务器的信息。

返回DBMS服务器的版本信息。

返回SQL执行的统计结果。 返回的结果包含执行SQL语句的数目和 所花费的总时间。 为了使用此方法，enableProfiling必须设置为 true。

返回连接的超时设置。

初始化组件。 该方法对IApplicationComponent 来说是必须的， 并且当 CDbConnection 被用作一个应用程序组件时触发。 如果你重写此方法，请确保调用父类实现 以便可以将组件标记为已初始化。

初始化开放数据库连接。 在数据库连接建立后，调用此方法对。 默认的实现是设置MySQL和PostgreSQL数据库连接的charset。

打开数据库连接，如果它当前没有打开

在一个查询中引用一个列名称。 如果该列名包含前缀，前缀也被恰当的引用。

在一个查询中引用的表名。 如果此表名包含schema 前缀，前缀也能被恰当的引用。

在一个查询中引用一个字符串值。

打开或关闭DB连接。

设置数据库连接上的一个属性。

设置一套数据库连接的属性。

设置是否创建或更新数据库记录将自动提交。 某些 DBMS (如 sqlite) 可能不支持这个特征。

设置列名称的大小写。

设置null和empty 字符串如何转换。

设置此连接是否是持久连接。 某些 DBMS (如 sqlite) 可能不支持这个特征。