Yii Framework v1.1.10 类参考

CActiveRecord

包	system.db.ar
继承	abstract class CActiveRecord » CModel » CComponent
实现	ArrayAccess, Traversable, IteratorAggregate
源自	1.0
版本	$Id: CActiveRecord.php 3533 2012-01-08 22:07:55Z mdomba $
源码	framework/db/ar/CActiveRecord.php

属性详细

返回所有列的属性值。 注意，不返回相关的对象。

返回此AR的命令生成器。

所有活动记录类的默认数据库连接。 默认情况下，这是'db'应用程序组件，

返回活动记录所使用的数据库连接。 默认情况下，"db"应用程序组件用作数据库连接。 如果您要使用一个不同的数据库连接，您可以重写此方法。

返回和这个模型相关的查询条件。

返回当前记录是否是新的。

返回这个AR的元数据。

返回旧的主键值。 这指的是主键值已填充到记录后， 执行查找方法 (例如： find()，findAll())， 即使主关键属性都会被手动分配一个不同的值，值保持不变。

返回主键值。

返回由 find 方法使用表的别名。 在关系查询，根据对应关系的声明， 返回的表的别名可能会有所不同。 此外，由setTableAlias可以由应用的范围覆盖。

返回表的元数据，这属于AR类。

方法详细

public mixed __call(string $name, array $parameters)
$name	string	方法名
$parameters	array	方法参数
{return}	mixed	此方法返回值

回调的命名方法。 请不要调用它，它不是类的方法。 这是我们重写一个PHP魔术方法实现了这个命名范围的功能。

public void __construct(string $scenario='insert')
$scenario	string	场景名。参见CModel::scenario关于这个参数的更多信息。

构造函数。

public mixed __get(string $name)
$name	string	属性名
{return}	mixed	属性值

PHP getter 魔术方法。 重写此方法，以便AR属性能像属性那样访问。

public boolean __isset(string $name)
$name	string	属性名或事件名
{return}	boolean	是否属性值为null

检测一个属性值是否为null。 通过检测，如果命令属性为空或不存在， 此方法重写父类。

public void __set(string $name, mixed $value)
$name	string	属性名
$value	mixed	属性值

PHP setter 魔术方法。 重写此方法，以便AR属性能像属性那样访问。

public array __sleep()
{return}	array

PHP sleep 魔术方法。 此方法确保模型元数据引用被设置为 null。

public void __unset(string $name)
$name	string	属性名或事件名

检查属性值是否为空。 通过检测，如果命令属性为空或不存在， 此方法重写父类。

public void addRelatedRecord(string $name, mixed $record, mixed $index)
$name	string	属性名称
$record	mixed	相关的记录
$index	mixed	相关对象集合中的索引值。 如果true，这意味着使用从零开始的整数索引。 如果false，它意味着HAS_ONE或BELONGS_TO对象和索引不需要。

不调用此方法。此方法用于内部CActiveFinder来填充相关的对象。 此方法添加到此记录的相关的对象。

protected void afterDelete()

删除记录之后调用此方法。 这个默认执行引发onAfterDelete事件。 您可以重写此方法，在记录被删除后做处理。 请确保您调用父实例，以便正确地引发该事件。

protected void afterFind()

每个记录由 find 方法实例化后，将调用此方法。 这个默认执行引发onAfterFind事件。 你可以重写这个方法， 做处理后每个新查找的记录实例。 请确保您调用父实例，以便正确地引发该事件。

public void afterFindInternal()

调用afterFind。 这个方法内部使用。

protected void afterSave()

记录被成功保存后，调用此方法。 这个默认执行引发onAfterSave事件。 您可重写此方法，以记录保存后做后处理。 请确保您调用父实例，以便正确地引发该事件。

public void applyScopes(CDbCriteria &$criteria)
$criteria	CDbCriteria	查询条件。通过合并dbCriteria可修改此参数。

适用于给定条件的查询范围。 这种方法合并dbCriteria与给定的条件参数。 它将重置dbCriteria为null。

public array attributeNames()
{return}	array	属性名称列表

返回模型的所有属性名称的列表。 这将返回AR类与此相关联的所有表的列名。

protected boolean beforeDelete()
{return}	boolean	是否应删除记录。默认值为true。

在删除记录之前调用此方法。 这个默认执行引发onBeforeDelete事件。 您可以重写此方法，以做为记录删除任何准备工作。 请确保您调用父实例，以便正确地引发该事件。

protected void beforeFind()

AR finder执行查找调用之前，将引发此事件。 查找调用包括find，findAll，findByPk， findAllByPk，findByAttributes和findAllByAttributes。 这个默认执行引发onBeforeFind事件。 如果重写此方法， 请确保您调用父实例，以便正确地引发该事件。

从1.1.5版本开始， 这种方法可称为一个隐藏的参数CDbCriteria表示当前查询条件传递到一个AR方法。

public void beforeFindInternal()

调用beforeFind。 这个方法内部使用。

protected boolean beforeSave()
{return}	boolean	是否应该执行可在，默认为true。

保存记录之前，调用这个方法（验证后，如果有的话）。 默认实现引发onBeforeSave事件。 您可以重写此方法做任何记录保存的准备工作。 使用isNewRecord 以确认是否是插入或保存记录。 请确保您调用父实例，以便正确地引发该事件。

public CActiveRecord cache(integer $duration, CCacheDependency $dependency=NULL, integer $queryCount=1)
$duration	integer	查询结果可能保持在缓存中有效的秒数。 如果这是0，缓存将被禁用。
$dependency	CCacheDependency	保存查询结果到缓存时使用的依赖关系。
$queryCount	integer	在调用此方法后，需要缓存的SQL查询的数目。 默认值为 1，这意味着下一个SQL查询将被缓存。
{return}	CActiveRecord	AR实例本身。

设置关于查询缓存的参数. 这是CDbConnection::cache()的一种快捷方法。 它改变查询缓存的dbConnection实例参数。

public string count(mixed $condition='', array $params=array ( ))
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数
{return}	string	满足指定的查询条件的行数。注：类型是字符串保持最大精度。

查找满足指定查询条件的行数。 参见find()详细说明关于$condition和$params。

public string countByAttributes(array $attributes, mixed $condition='', array $params=array ( ))
$attributes	array	列表中的属性值（属性名索引）活动记录相匹配。 属性值可以是一个数组，用于生成的条件。
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数
{return}	string	满足指定的查询条件的行数。注：类型是字符串保持最大精度。

查找具有指定的属性值的行数。 参见find()详细说明关于$condition和$params。

public string countBySql(string $sql, array $params=array ( ))
$sql	string	SQL语句
$params	array	要绑定到的 SQL 语句的参数
{return}	string	满足指定的查询条件的行数。注：类型是字符串保持最大精度。

查找指定SQL语句影响的行数。 这相当于调用CDbCommand::queryScalar， 以指定的SQL声明和参数。

public array defaultScope()
{return}	array	查询条件。 这将作为CDbCriteria参数的构造方法。

返回默认的命名范围，应隐含这种模式适用于所有查询。 注意，默认的范围只适用于SELECT查询。忽视对INSERT，UPDATE和DELETE查询。 默认实现只返回一个空数组。 如果模型需要一些默认的标准（如只有活动记录，当返回）查询，你可以重写此方法。

public boolean delete()
{return}	boolean	是否删除成功。

删除对应于此活动记录的行。

public integer deleteAll(mixed $condition='', array $params=array ( ))
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数
{return}	integer	删除的行数

删除指定条件的行。 参见find()详细说明关于$condition和$params。

public integer deleteAllByAttributes(array $attributes, mixed $condition='', array $params=array ( ))
$attributes	array	列表中的属性值（属性名索引）活动记录相匹配。 属性值可以是一个数组，用于生成的条件。
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数
{return}	integer	执行影响的行数。

删除指定的属性值相匹配的行。 参见find()详细说明关于$condition和$params。

public integer deleteByPk(mixed $pk, mixed $condition='', array $params=array ( ))
$pk	mixed	主键值。对多个主键使用数组。复合键，对于每个键的值必须是一个数组（列名=>列值）。
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数
{return}	integer	删除的行数

删除指定主键的行。 参见find()详细说明关于$condition和$params。

public boolean equals(CActiveRecord $record)
$record	CActiveRecord	要比较的记录
{return}	boolean	两个活动的记录是否是指数据库表中的同一行。

当前活动记录与另一个比较。 通过比较表名和两个活动记录的主键值来作比较。

public boolean exists(mixed $condition='', array $params=array ( ))
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数
{return}	boolean	是否满足指定条件的行。

检查是否满足指定条件的行。 参见find()详细说明关于$condition和$params。

public CActiveRecord find(mixed $condition='', array $params=array ( ))
$condition	mixed	查询条件或标准。 如果一个字符串，它被作为查询条件 （WHERE 子句） ； 如果一个数组，它被视为构建CDbCriteria对象初始值; 否则，它应该是CDbCriteria对象的一个实例。
$params	array	要绑定到的 SQL 语句的参数。 这仅仅是第一个参数是一个字符串（查询条件）时使用。 在其他情况下，请使用CDbCriteria::params设置参数。
{return}	CActiveRecord	找到的记录。如果没找到任何记录，则为 null。

查找指定条件的单个活动记录。

public array findAll(mixed $condition='', array $params=array ( ))
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数。
{return}	array	满足指定条件的活动记录列表，如果没有找到将返回一个空的数组。

查找满足指定条件的所有活动记录。 参见find()详细说明关于$condition和$params。

public array findAllByAttributes(array $attributes, mixed $condition='', array $params=array ( ))
$attributes	array	列表中的属性值（属性名索引）活动记录相匹配。 属性值可以是一个数组将被用来生成一个条件。
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数。
{return}	array	找到的记录。如果没有找到返回一个空数组。

查找具有指定属性值的所有活动记录。 参见find()详细说明关于$condition和$params。

public array findAllByPk(mixed $pk, mixed $condition='', array $params=array ( ))
$pk	mixed	主键值。对多个主键使用数组。复合键，对于每个键的值必须是一个数组（列名=>列值）。
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数。
{return}	array	找到的记录。如果没有找到返回一个空数组。

查找指定主键的所有活动记录。 参见find()详细说明关于$condition和$params。

public array findAllBySql(string $sql, array $params=array ( ))
$sql	string	SQL语句
$params	array	要绑定到的 SQL 语句的参数
{return}	array	找到的记录。如果没找到任何记录，则为 null。

查找指定SQL语句的所有活动记录。

public CActiveRecord findByAttributes(array $attributes, mixed $condition='', array $params=array ( ))
$attributes	array	列表中的属性值（属性名索引）活动记录相匹配。 属性值可以是一个数组将被用来生成一个条件。
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数。
{return}	CActiveRecord	找到的记录。如果没找到任何记录，则为 null。

查找具有指定属性值的单个活动记录。 参见find()详细说明关于$condition和$params。

public CActiveRecord findByPk(mixed $pk, mixed $condition='', array $params=array ( ))
$pk	mixed	主键值。对多个主键使用数组。复合键，对于每个键的值必须是一个数组（列名=>列值）。
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数。
{return}	CActiveRecord	找到的记录。如果没找到任何记录，则为 null。

查找指定主键的单一活动记录。 参见find()详细说明关于$condition和$params。

public CActiveRecord findBySql(string $sql, array $params=array ( ))
$sql	string	SQL语句
$params	array	要绑定到的 SQL 语句的参数
{return}	CActiveRecord	找到的记录。如果没找到任何记录，则为 null。

查找指定SQL语句的单个活动记录。

public CActiveRelation getActiveRelation(string $name)
$name	string	关系名称
{return}	CActiveRelation	为此AR类声明命名的关系。如果关系不存在则为null。

返回此AR类声明的命名关系。

public mixed getAttribute(string $name)
$name	string	属性名称
{return}	mixed	属性值。如果属性未设置​​或不存在则为null。

返回命名的属性值。 如果这是一个新的记录，该属性未设置之前， 将返回的列的默认值。 如果该记录是查询的结果并不加载该属性时， 将返回null。 你也可以使用$this->AttributeName来获得属性值。

public string getAttributeLabel(string $attribute)
$attribute	string	属性名称
{return}	string	属性标签

返回指定属性的文本标签。 这个方法重写父类， 支持返回关系对象中定义的标签。 特别注意，如果属性名称是"post.author.name"的形式， 那么此方法会从"author"关系"name"中获得属性标签。

public array getAttributes(mixed $names=true)
$names	mixed	属性的名称，其值必须返回。 如果这是true（默认），将返回所有属性， 包括那些没有从数据库加载的（这些属性将返回空）。 如果为null，则将返回所有属性，数据库未被加载的除外。
{return}	array	attribute values indexed by attribute names.

返回所有列的属性值。 注意，不返回相关的对象。

public CDbCommandBuilder getCommandBuilder()
{return}	CDbCommandBuilder	这个命令生成器属于AR类

返回此AR的命令生成器。

public CDbConnection getDbConnection()
{return}	CDbConnection	活动记录使用的数据库连接。

返回活动记录所使用的数据库连接。 默认情况下，"db"应用程序组件用作数据库连接。 如果您要使用一个不同的数据库连接，您可以重写此方法。

public CDbCriteria getDbCriteria(boolean $createIfNull=true)
$createIfNull	boolean	是否创建一个条件实例如果它不存在。默认值为true。
{return}	CDbCriteria	和这个模型相关的查询条件。 这个条件主要被 named scope使用， 特征是积累不同的条件规范。

返回和这个模型相关的查询条件。

public boolean getIsNewRecord()
{return}	boolean	该记录是否是新的，就插入时调用save。 在构造函数和populateRecord自动设置此属性。 默认值为false， 如果使用new运算符创建实例，它会被设置为true。

返回当前记录是否是新的。

public CActiveRecordMetaData getMetaData()
{return}	CActiveRecordMetaData	这个AR类的元数据。

返回这个AR的元数据。

public mixed getOldPrimaryKey()
{return}	mixed	旧的主键值。则返回数组（列名=>列值）如果主键是复合型。 If primary key is not defined, null will be returned.

返回旧的主键值。 这指的是主键值已填充到记录后， 执行查找方法 (例如： find()，findAll())， 即使主关键属性都会被手动分配一个不同的值，值保持不变。

public mixed getPrimaryKey()
{return}	mixed	主键值。则返回数组（列名=>列值）如果主键是复合型。 如果没有定义主键，将返回null。

返回主键值。

public mixed getRelated(string $name, boolean $refresh=false, array $params=array ( ))
$name	string	关系名 (参见relations)
$refresh	boolean	是否从数据库重新载入相关对象，默认值为false。
$params	array	附加参数，在关系声明中指定自定义查询条件。
{return}	mixed	相关对象.

返回相关的记录。 这个方法将返回当前记录的相关记录。 如果关系是 HAS_ONE 或 BELONGS_TO， 如果对象不存在，将返回一个单个对象或null。 如果关系是HAS_MANY 或 MANY_MANY， 它返回一个对象数组或一个空数组。

public string getTableAlias(boolean $quote=false, boolean $checkScopes=true)
$quote	boolean	是否要引用别名
$checkScopes	boolean	检测别名当前是否在应用范围被定义。 调用defaultScope此方法时，这个参数必须被设置为false。 否则将形成一个无限循环。
{return}	string	默认表别名

返回由 find 方法使用表的别名。 在关系查询，根据对应关系的声明， 返回的表的别名可能会有所不同。 此外，由setTableAlias可以由应用的范围覆盖。

public CDbTableSchema getTableSchema()
{return}	CDbTableSchema	这个表的元数据属于AR类

返回表的元数据，这属于AR类。

public boolean hasAttribute(string $name)
$name	string	属性名称
{return}	boolean	这是否是AR命名的属性(table column).

检查此AR是否有命名的属性。

public boolean hasRelated(string $name)
$name	string	关系名
{return}	boolean	返回一个值指示是否命名相关对象被载入。

返回一个值，该值指示是否已加载命名的相关对象。

public void init()

初始化这个模型。 当一个AR实例是新创建的或有它的scenario设置， 这个方法被触发。 您可以重写此方法以提供所需的初始化的代码模型 (例如：设置初始的属性值)。

public boolean insert(array $attributes=NULL)
$attributes	array	需要保存的属性列表。默认为null， 这意味着从数据库中加载的所有属性将被保存。
{return}	boolean	属性是否有效，并将记录插入成功。

插入一行到基于这个ActiveRecord的属性表。 如果表的主键是自动增量和插入前为null， 将插入后的实际值填充。 注意，验证不执行此方法。你可以调用validate执行验证。 记录成功插入到数据库后，它的isNewRecord属性将设置为false， 和它的scenario属性将设置为‘update’。

protected CActiveRecord instantiate(array $attributes)
$attributes	array	活动记录的属性值列表。
{return}	CActiveRecord	活动记录

创建活动记录实例。 这个方法调用populateRecord和populateRecords。 如果正在创建的实例， 你可以重写此方法，取决于填充纪录的属性。 例如，通过创建基于列的值的记录， 你可以实现所谓的单表继承映射。

public static CActiveRecord model(string $className='CActiveRecord')
$className	string	活动记录类的名称。
{return}	CActiveRecord	活动记录模型的一个实例。

返回指定AR类的静态模型。 返回的模型是一个静态的AR类的实例。 它提供了用于调用类级别的方法（某些似乎于静态类方法。）

每个派生类必须重写此方法如下，

public static function model($className=__CLASS__)
{
    return parent::model($className);
}

public boolean offsetExists(mixed $offset)
$offset	mixed	检查到的偏移量
{return}	boolean

返回是否有指定偏移量的元素。 这种方法需要接口ArrayAccess。

public void onAfterDelete(CEvent $event)
$event	CEvent	事件参数

在删除记录之后，将引发此事件。

public void onAfterFind(CEvent $event)
$event	CEvent	事件参数

引发此事件记录后找到方法的实例。

public void onAfterSave(CEvent $event)
$event	CEvent	事件参数

保存记录之后，将引发此事件。

public void onBeforeDelete(CModelEvent $event)
$event	CModelEvent	事件参数

在删除记录之前，将引发此事件。 通过设置CModelEvent::isValid为false，正常delete()进程被停止。

public void onBeforeFind(CModelEvent $event)
$event	CModelEvent	事件参数

AR finder执行查找调用之前，将引发此事件。 在这种情况下，这CModelEvent::criteria个属性作为参数传递给此方法作为查询条件。 如果你要访问范围中指定的查询条件， 请使用getDbCriteria()。 你可以修改任何条件，根据需求定制。

public void onBeforeSave(CModelEvent $event)
$event	CModelEvent	事件参数

保存记录之前，将引发此事件。 通过设置CModelEvent::isValid为false，正常save()进程被停止。

public CActiveRecord populateRecord(array $attributes, boolean $callAfterFind=true)
$attributes	array	属性值（列名=>列值）
$callAfterFind	boolean	是否要记录后调用afterFind填充。
{return}	CActiveRecord	新创建的活动记录。类的对象是相同的模型类。 如果输入的数据是false，则返回null。

给指定的属性创建活动记录 此方法由 find 方法内部使用。

public array populateRecords(array $data, boolean $callAfterFind=true, string $index=NULL)
$data	array	活动记录的属性值列表。
$callAfterFind	boolean	是否要记录后调用afterFind填充。
$index	string	其值将用作查询结果数组索引属性的名称。 如果为null，这意味着将从零开始的整数索引的数组。
{return}	array	活动记录的列表

创建基于输入数据的活动记录的列表。 此方法由 find 方法内部使用。

public mixed primaryKey()
{return}	mixed	相关数据表的主键。 如果该键是一个单一的列，它应当返回列的名称； 如果键是由多个列组成的复合键, 它应该返回数组的键列名称。

返回相关数据库表的主键。 这种方法是指表没有定义主键时（一些legency数据库）的情况下重写。 如果表已定义主键， 你不需要重写此方法。默认实现只返回null， 意思是返回在数据库中定义的主键。

protected mixed query(CDbCriteria $criteria, boolean $all=false)
$criteria	CDbCriteria	the query criteria
$all	boolean	whether to return all data
{return}	mixed	the AR objects populated with the query result

执行实际的数据库查询和填充AR对象的查询结果。 此方法由其他 AR 查询方法调用，主要是内部使用。

public boolean refresh()
{return}	boolean	该行是否仍然存在于数据库中。如果情况属实，最新的数据将被填充到这个活动记录。

最新的数据将被填充到这个活动记录。

public void refreshMetaData()

刷新这个AR类的元数据。 通过调用这个方法，这个AR类将重新生成需要的元数据。 如果表的结构已经改变，且你想要使用最新的，这是非常有用的。 在你调用这个方法前，确保你已经调用CDbSchema::refresh， 要不然，旧表的的数据结构仍被使用。

public array relations()
{return}	array	相关对象申明列表。 默认值为空数组。

申明关系的对象，应重写此方法。

可能存在两个活动记录对象之间的关系有四种类型：

• BELONGS_TO: 例如，成员属于一个团队；
• HAS_ONE: 例如，成员有个人资料；
• HAS_MANY: 例如，一个团队有很多成员；
• MANY_MANY: 例如，成员有很多的技巧和技能是属于这个成员的；

除了上述的关系类型， 还支持一种特殊的关系称为STAT，可以用来进行统计查询（或聚合查询）。 它检索聚合对相关对象的信息， 如每个帖子，对于每个产品，平均分数为注释的数目等。

相关对象的每个类定义在此方法中作为具有以下元素的数组：

'varName'=>array('relationType', 'className', 'foreign_key', ...additional options)

其中‘varName’是批变量/属性的名称，可以通过对象来访问； ‘relationType’是指关系的类型，它可以是以下四种常量之一， self::BELONGS_TO，self::HAS_ONE，self::HAS_MANY 和 self::MANY_MANY； ‘className’是指活动记录类的相关对象的名称； 和‘foreign_key’规定的外键涉及两种活动记录。 请注意复合外键， 他们可以一起列出，以逗号分隔，或者作为一个数组指定数组的格式（‘key1，key2’）。 如果你需要指定自定义的pk->fk关联，你可以定义数组（‘fk’=> ‘pk'）。 对于组合键这将是数组（‘fk_c1’=>‘pk_с1’，‘fk_c2’=>‘pk_c2’）。 MANY_MANY关系中使用外键， 加入表必须声明为（例如：‘join_table(fk1，fk2)’）。

其余数组元素的名称-值，可以指定其他选项：

• 'select': string|array, 被选中的列列表。默认值为 '*'，这意味着是所有列。 如果它们出现在一个表达式中（例如： COUNT(relationName.name) AS name_count）。
• 'condition': string, WHERE子句。 默认值为空。 注意，列引用需要加入'relationName'前缀 。(例如：relationName.age>20)
• 'order': string, ORDER BY子句。 默认值为空。 注意，列引用需要加入'relationName'前缀 。(例如：relationName.age DESC)
• 'with': string|array, 应该与这个对象一起装载的子对象相关名单。 注意，这仅仅是延迟加载，而不是预先加载。
• 'joinType': 联接类型。 默认值为‘LEFT OUTER JOIN’。
• 'alias': 关系与关联表的别名。 它默认为null， 意味着表的别名与关系名称相同。
• 'params': 参数绑定到要生成的SQL语句上。 这应作为名称-值的数组。
• 'on': ON 子句。 此处指定的条件将追加到使用 AND 运算符的联接条件。
• 'index': 其值应作为存储相关的对象的数组的键的列的名称。 此选项仅适用于， HAS_MANY 和 MANY_MANY 关系。
• 'scopes': 应用范围。在单一的范围情况下可以像'scopes'=>'scopeName'， 在多个作用域范围情况下可以使用数组像这样'scopes'=>array('scopeName1','scopeName2')。 此选项自版本 1.1.9 可用。

延迟加载时有一定的关系，下列选项可用：

• 'group': string, GROUP BY子句。 默认值为空。 注意，列引用需要加入'relationName'前缀 。(例如： relationName.age)。此选项仅适用于HAS_MANY 和 MANY_MANY 关系。
• 'having': string, HAVING子句。 默认值为空。 注意，列引用需要加入'relationName'前缀 。(例如： relationName.age)。此选项仅适用于HAS_MANY 和 MANY_MANY 关系。
• 'limit': 数据行的limit选择。 这个选项不能应用到BELONGS_TO。
• 'offset': 数据行的偏移量。 这个选项不能应用到BELONGS_TO。
• 'through': 获取相关的数据时将用作桥的模型的关系的名称。可以设置仅为 HAS_ONE 和 HAS_MANY。此选项自版本 1.1.7 可用。

以下是一个例子，为 'Post' 活动记录类相关对象的一个示例：

return array(
    'author'=>array(self::BELONGS_TO, 'User', 'author_id'),
    'comments'=>array(self::HAS_MANY, 'Comment', 'post_id', 'with'=>'author', 'order'=>'create_time DESC'),
    'tags'=>array(self::MANY_MANY, 'Tag', 'post_tag(post_id, tag_id)', 'order'=>'name'),
);

public CActiveRecord resetScope()
{return}	CActiveRecord

重置所有变量作用域，包括默认的范围。

public boolean save(boolean $runValidation=true, array $attributes=NULL)
$runValidation	boolean	保存记录之前是否执行验证。 如果验证失败，记录不会被保存到数据库。
$attributes	array	需要保存的属性列表。 默认为null，这意味着从数据库中加载的所有属性将被保存。
{return}	boolean	whether the saving succeeds

保存当前的记录。

插入记录到数据表的一行， 如果它的isNewRecord属性为true（通常情况下使用的‘new’运算符来创建记录）。 否则， 将被用于更新表中的相应行（通常情况下，使用‘find’方法来查找记录）。

保存记录之前将执行验证。 如果验证失败，该记录将不会保存。 你可以调用getErrors()检索验证错误。

如果该记录通过插入保存， 它isNewRecord的属性会被设置为false，和它的scenario属性被设置为‘update’。 如果其主键是自动增量，并且在插入之前未设置， 将使用自动生成的值来填充主键。

public boolean saveAttributes(array $attributes)
$attributes	array	要更新的属性。 每个元素表示的属性名称或按其名称索引的属性值。 如果是后者，记录的属性将据此之前保存的更改。
{return}	boolean	更新是否成功

保存所选的属性列表。 不同于save，这个方法只保存现有的列数据集的指定的属性， 并且不调用beforeSave或afterSave。 请注意这个方法不过滤属性也不做验证。 所以不要这种方法接受不受信任的数据（如用户发布的数据）。 如果你想这样做，可以考虑以下方法代替：

$postRecord=Post::model()->findByPk($postID);
$postRecord->attributes=$_POST['post'];
$postRecord->save();

public boolean saveCounters(array $counters)
$counters	array	要更新计数器（列名=>增量值）
{return}	boolean	保存是否成功

保存一个或多当前AR对象到计数器。 请注意，此方法不同于updateCounters ， 它只保存当前AR对象。 用法示例如下所示：

$postRecord=Post::model()->findByPk($postID);
$postRecord->saveCounters(array('view_count'=>1));

如果你想减少计数器，请使用负值。

public array scopes()
{return}	array	范围的界定。数组中的键范围名称; 数组中的值是相应的范围定义。 每个范围定义被表示为一个数组，其键必须是CDbCriteria的属性。

返回申明的命名范围。 代表一个查询条件的命名范围，可以串连在一起与其他的命名范围和查询。 这种方法应该重写， 子类声明为特定的AR类的命名范围。 例如， 下面的代码声明两个命名范围‘recently’和‘published’。

return array(
    'published'=>array(
          'condition'=>'status=1',
    ),
    'recently'=>array(
          'order'=>'create_time DESC',
          'limit'=>5,
    ),
);

如果上述范围的申明在Post模型， 我们可以执行以下查询：

$posts=Post::model()->published()->findAll();
$posts=Post::model()->published()->recently()->findAll();
$posts=Post::model()->published()->with('comments')->findAll();

需要注意的是最后一个查询是一个关联查询。

public boolean setAttribute(string $name, mixed $value)
$name	string	属性名称
$value	mixed	属性值
{return}	boolean	属性是否存在和任务成功进行

设置命名的属性值。 你也可以使用$this->AttributeName来设置属性值。

public void setDbCriteria(CDbCriteria $criteria)
$criteria	CDbCriteria	查询条件

为当前模型设置查询条件.

public void setIsNewRecord(boolean $value)
$value	boolean	该记录是否是新的，就插入时调用save。

设置记录是否是新的。

public void setOldPrimaryKey(mixed $value)
$value	mixed	旧主键值。

设置旧的主键值。

public void setPrimaryKey(mixed $value)
$value	mixed	新的主键值。如果主键是复合类型， 应提供一个新值做为数组（列名=>列值）。

设置主键值。 调用此方法后，旧的主键值，可以从oldPrimaryKey得到。

public void setTableAlias(string $alias)
$alias	string	在查询中使用表的别名。别名不应该加引号。

设置表在查询中使用的别名。

public string tableName()
{return}	string	返回表名

返回关联的数据库表的名称。 默认情况下，这个方法返回类名作为表名。 你可以覆盖这个方法，如果此列没有命名在这次约定之后。

public CActiveRecord together()
{return}	CActiveRecord	AR对象本身。

设置CDbCriteria::together属性为true。 这只用于关系AR查询。 请参见CDbCriteria::together更多详细。

public boolean update(array $attributes=NULL)
$attributes	array	需要保存的属性列表。默认为null， 这意味着从数据库中加载的所有属性将被保存。
{return}	boolean	更新是否成功

更新此活动记录所表示的行。 已加载的所有属性都将保存到数据库中。 注意，验证不执行此方法。你可以调用validate执行验证。

public integer updateAll(array $attributes, mixed $condition='', array $params=array ( ))
$attributes	array	用于更新的属性列表（name=>$value）。
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数
{return}	integer	被更新的行数

更新使用指定条件的记录。 参见find()详细说明关于$condition和$params。 注意，属性没有做安全检测和校验。

public integer updateByPk(mixed $pk, array $attributes, mixed $condition='', array $params=array ( ))
$pk	mixed	主键值。对多个主键使用数组。复合键，对于每个键的值必须是一个数组（列名=>列值）。
$attributes	array	用于更新的属性列表（name=>$value）。
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数
{return}	integer	被更新的行数

更新指定主键记录的行。 参见find()详细说明关于$condition和$params。 注意，属性没有做安全检测和校验。

public integer updateCounters(array $counters, mixed $condition='', array $params=array ( ))
$counters	array	要更新的计数器（列名=>增量值）
$condition	mixed	查询条件或标准。
$params	array	要绑定到的 SQL 语句的参数
{return}	integer	被更新的行数

更新的一个或多个计数器。 请注意，除非指定一个条件或标准，这将更新所有数据行。 参见find()详细说明关于$condition和$params。

public CActiveRecord with()
{return}	CActiveRecord	AR对象本身。

指定相关对象应一起载入。 这个方法采取变量的参数。 每个参数指定关系或子关系的名称。例如，

// find all posts together with their author and comments
Post::model()->with('author','comments')->findAll();
// find all posts together with their author and the author's profile
Post::model()->with('author','author.profile')->findAll();

应用中声明的关系relations()。

默认情况下，在指定的relations()选项将被用来做关联查询。 为了自定义动态选项，我们应将一个数组参数传递给 with() 方法。 数组的键是关系的名称， 和数组值对应的查询选项。 例如：

Post::model()->with(array(
    'author'=>array('select'=>'id, name'),
    'comments'=>array('condition'=>'approved=1', 'order'=>'create_time'),
))->findAll();