Yii framwork crud 命名范围NAMED SCOPE_PHP教程
- WBOY原創
- 2016-07-14 10:10:06897瀏覽
命名范围
Note: 对命名范围的支持从版本 1.0.5 开始。 命名范围的最初想法来源于 Ruby on Rails.
命名范围(named scope) 表示一个 命名的（named）查询规则，它可以和其他命名范围联合使用并应用于 Active Record 查询
命名范围主要是在 CActiveRecord::scopes() 方法中以名字-规则对的方式声明。如下代码在 Post 模型类中声明了两个命名范围,
published 和 recently。
class Post extends CActiveRecord
{
......
public function scopes()
{
return array(
'published'=>array(
'condition'=>'status=1',
),
'recently'=>array(
'order'=>'create_time DESC',
'limit'=>5,
),
);
}
}
具体使用： $posts=Post::model()->published()->recently()->findAll();
注意: 命名范围只能用于类级别方法。也就是说，此方法必须使用 ClassName::model() 调用。
参数化的命名范围
命名范围可以参数化。例如， 我们想自定义 recently 命名范围中指定的帖子数量，要实现此目的，不是在CActiveRecord::scopes
方法中声明命名范围， 而是需要定义一个名字和此命名范围的名字相同的方法：
public function recently($limit=5)
{
$this->getDbCriteria()->mergeWith(array(
'order'=>'create_time DESC',
'limit'=>$limit,
));
return $this;
}
然后，我们就可以使用如下语句获取3条最近发布的帖子。
$posts=Post::model()->published()->recently(3)->findAll();//上面的代码中，默认获取 5 条最近发布的帖子。
默认范围
模型类可以有一个默认范围，它将应用于所有 (包括相关的那些) 关于此模型的查询。例如，一个支持多种语言的网站可能只想显
示当前用户所指定的语言的内容。 因为可能会有很多关于此网站内容的查询， 我们可以定义一个默认范围以解决此问题。 为实
现此目的，我们覆盖 CActiveRecord::defaultScope 方法如下：
class Content extends CActiveRecord
{
public function defaultScope()
{
return array(
'condition'=>"language='".Yii::app()->language."'",
);
}
}
现在，如果下面的方法被调用，将会自动使用上面定义的查询规则：$contents=Content::model()->findAll();
实际应用
上面的是几个官方给出的例子，下面是我自己使用的例子供大家参考一下：
TABLE：
school:id(pk,int),name(varchar) //学校
class:id(pk,int),name(varchar),s_id(fk,int) //班级
student:id(pk,int),name(varchar),s_id(int),c_id(int) //学生
例子：查询为学校为“a"的，所有班级，这时我们可以先在School模型中的relations方法中定义一个关系方便调用
public function relations()
{
return array(
'class'=>array(self::HAS_MANY, 'Class', 's_id'),
);
}
public function scopes()
{
return array(
'getAllClass'=>array(
'with'=>'class',
),
};
}
public function getAllClass($name)
{
$this->getDbCriteria()->mergeWith(array(
'condition'=>"t.name=$name",
));
return $this;
}
使用：School::model()->getAllClass("a")->findAll();