开源PHP开发框架Yii全方位教程 (11) Active Record (AR)

 

虽然Yii DAO可以处理事实上任何数据库相关的任务，但编写一些通用的SQL语句来执行CRUD操作（创建，读取，更新和删除）往往会让我们花费掉90%的时间。同时我们也很难维护这些PHP和SQL语句混合的代码。要解决这些问题，我们可以使用Active Record。
Active Record（AR）是一种流行的对象关系映射（ORM）技术。每个AR类代表一个数据表（或视图），数据表或者视图的字段作为AR类的属性，一个AR实例代表在表中的一行。常见的CRUD操作被作为AR类的方法执行。于是，我们可以使用更面向对象的方法处理我们的数据。例如，我们可以使用下面的代码在 tbl_post表中插入一个新行：

$post=new Post;
$post->title='sample post';
$post->content='post body content';
$post->save();

在下面我们将介绍如何设置AR和用它来执行CRUD操作。在下一小节我们将展示如何使用AR 处理数据库中的关联表。为了简单起见，在本节中，我们使用下面的数据库表作为例子。请注意，如果你使用MySQL数据库，您应该把下面SQL语句中的 AUTOINCREMENT替换为AUTO_INCREMENT。

CREATE TABLE tbl_post (
    id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
    title VARCHAR(128) NOT NULL,
    content TEXT NOT NULL,
    create_time INTEGER NOT NULL
);

AR不是要解决所有与数据库相关的任务。它最好用于在PHP结构中模型化数据表和执行不复杂的 SQL 语句. 而 Yii DAO 应该用于复杂的情况下。

建立数据库连接

AR需要一个数据库连接以执行数据库相关的操作。默认情况下，应用中的db组件提供了 CDbConnection实例作为我们需要的数据库连接。可参看如下配置：

return array(
    'components'=>array(
        'db'=>array(
            'class'=>'system.db.CDbConnection',
            'connectionString'=>'sqlite:path/to/dbfile',
            // turn on schema caching to improve performance
            // 'schemaCachingDuration'=>3600,
        ),
    ),
);

由于Active Record需要表的元数据来确定数据表的字段信息， 这需要时间来读取和分析元数据。如果您的数据库结构是比较固定的，你应该打开缓存。 打开方法是配置CDbConnection::schemaCachingDuration属性为一个大于0的值。

AR的支持受限于数据库管理系统。目前，只有以下数据库管理系统支持：

• MySQL 4.1 或以后版本
• PostgreSQL 7.3 或以后版本
• SQLite 2 和 3
• Microsoft SQL Server 2000 或以后版本
• Oracle

Microsoft SQL Server自1.0.4版本提供支持;而对 Oracle 自1.0.5版本即提供支持。

如果你想使用其他组件而不是db，或者你使用 AR 访问多个数据库,你应该重写CActiveRecord::getDbConnection()。 CActiveRecord类是所有AR类的基类。

有两种方法可以在AR模式下使用多种数据库系统。如果数据库的模式不同， 您可以对getDbConnection()进行不同的实现，来创建不同的 AR 基类。否则，动态改变静态变量CActiveRecord::db 是一个更好的主意。

定义 AR 类

为了使用一个数据表，我们首先需要扩展CActiveRecord来定义一个AR类。每个AR类代表一个数据库表，每个AR实例代表数据表中的一行。下面的代码介绍了要创建一个对应tbl_post表的AR类所需要的最少的代码。

class Post extends CActiveRecord
{
        public static function model($className=<strong>CLASS</strong>)
        {
        return parent::model($className);
        }
        public function tableName()
        {
        return ’tbl_post’;
        }
}

因为AR类在很多地方被引用,我们可以导入包含AR类的整个目录，而不是逐个引入它们.例如,若我们所有的AR类文件位于 protected/models,我们可以如下配置:

return array(
  ’import’=>array(
      ’application.models.*’,
  ),
);

默认的, AR 类的名字和数据表的名字相同. 若它们不同需要重写 tableName() 方法. 每个AR类的model()方法都如此声明(会在稍后介绍).

要使用版本 1.1.0 引入的表前缀特征, AR 的方法 tableName() 可