yii框架详解 之 CActiveRecord

【特别注意事项】

1、所有要用于访问的属性，都要先在类中声明（原数据表中的字段是默认可访问的，自定义的属性值，一定要先在类中添加声明，才可以正常访问）

2、数据库的表面引用，一般都是有固定的数据库表前缀的，在类中，使用 {{tableName}} 代表着 table_pre.tableName

3、model()方法是 static 方法，不用实例化即可直接使用，多用于查询。

4、rules() 方法 是用来验证字段合法性的，而且可以设置每个规则的应用环境标示，如 'on'=>'search'，这点要好好利用。

5、attributeLabels() 方法是设置每个字段的描述信息。

6、search()方法，用来查询

【如何获取关联数据表的其他字段值】

1）首先在关系声明里，指定要查询的字段别名

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19

/**      * @return array relational rules.      */     public function relations()     {         // NOTE: you may need to adjust the relation name and the related         // class name for the relations automatically generated below.         return array(             'visas'=>array(self::MANY_MANY, 'Visa',                 '{{visa_to_order}}(id_order, id_visa)',                 'select'=>array(                     '*',                                  #获取所有字段                    'visas_visas.price AS price_visa',     #visas_visas是关系表的别名，获取关系表里的字段值                 ),             ),               'user'=>array(self::BELONGS_TO, 'User','id_customer)'),         );     }

2）然后，将关系别名在AR实体里增加保存其值的属性。

class Visa extends CActiveRecord

{

    public $price_visa;

}

3）然后通过关联实体来访问该别名字段的值。

$orderModel->visas[0]->price_visa;

【BELONGS_TO关系表，关联的keyid如何自定义指定】

Yii的relations里self::BELONGS_TO默认是用当前指定的键跟关联表的主键进行join，例如：

return array(
'reply' => array(self::BELONGS_TO, 'BookPostReply', 'postid'),
);

默认生成的sql是 on id = postid，id是BookPostReply的主键。
但今天我遇到的需求却是需要生成 on BookPostReply.postid = t.postid，不去关联主键，

后来无意中看到有个on的属性，刚好跟sql里的on一样，于是抱着试试的想法，在配置里加了上去

return array(
'reply' => array(self::BELONGS_TO, 'BookPostReply', 'postid', 'on' => 't.postid=reply.postid'),
);

看调试信息里的SQL语句，发现yii生成了一条 on id = postid and t.postid=reply.postid 这样的语句，看到这就已经明白这个东西的作用了，于是将postid清空，改成如下：

return array(
'reply' => array(self::BELONGS_TO, 'BookPostReply', '', 'on' => 't.postid=reply.postid'),
);

其实，Yii的文档有说明： 如果你需要指定自定义的pk->fk关联，你可以定义数组（‘fk’=> ‘pk'）。

【多条件下关联查询结果集】

案例：

$this->news = News::model()->with(array(

'sites'=>array('condition'=>'sites.id_site='.Yii::app()->params['siteId'],'together'=>true),

'categories'=>array('condition'=>'categories.id_category='.$this->categoryId,'together'=>true),

))->findAll(array(

'limit'=>$this->limit,

'condition'=>'t.active=1',

'order'=>'t.position'

));

使用with('关系名称1','关系名称2')方法，将延后查询关联表，

若如上案例，在with方法中，返回关系数组，将更灵活。

若想即时联合查询，需要添加'together'=>true属性值，才会组合为一句SQL进行查询。

我们来看下CActiveRecord.php文件里，yii是如何设计with（）方法的。

/**

* Specifies which related objects should be eagerly loaded.

* This method takes variable number of parameters. Each parameter specifies

* the name of a relation or child-relation. For example,

* <pre>

* // 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();

* </pre>

* The relations should be declared in {@link relations()}.

*

* By default, the options specified in {@link relations()} will be used

* to do relational query. In order to customize the options on the fly,

* we should pass an array parameter to the with() method. The array keys

* are relation names, and the array values are the corresponding query options.

* For example,

* <pre>

* Post::model()->with(array(

*     'author'=>array('select'=>'id, name'),

*     'comments'=>array('condition'=>'approved=1', 'order'=>'create_time'),

* ))->findAll();

* </pre>

*

* @return CActiveRecord the AR object itself.

*/

public function with()

{

if(func_num_args()>0)

{

$with=func_get_args();

if(is_array($with[0]))  // the parameter is given as an array

$with=$with[0];

if(!empty($with))

$this->getDbCriteria()->mergeWith(array('with'=>$with));

}

return $this;

}

我们再去看 CDbCriteria 类中的 mergeWith 方法定义：

/**

* Merges with another criteria.

* In general, the merging makes the resulting criteria more restrictive.

* For example, if both criterias have conditions, they will be 'AND' together.

* Also, the criteria passed as the parameter takes precedence in case

* two options cannot be merged (e.g. LIMIT, OFFSET).

* @param mixed $criteria the criteria to be merged with. Either an array or CDbCriteria.

* @param string|boolean $operator the operator used to concatenate where and having conditions. Defaults to 'AND'.

* For backwards compatibility a boolean value can be passed:

* - 'false' for 'OR'

* - 'true' for 'AND'

*/

public function mergeWith($criteria,$operator='AND'){......}

注意，这里就是我要强调的地方，yii默认且只执行关联表之间的AND条件查询，也就是说，在给定不同条件查询时，yii只为我们求取不同条件的交集结果返回。

但是在底层的CDbCriteria 类中，预留了参数$operator给我们。有需求的同学需要重写CActiveRecord来实现拓展了哦。

来自为知笔记(Wiz)