概述
命名范圍功能,給模型操作提供了一系列的(連貫操作)封裝,讓你更方便的查詢和操作數據。我們來具體了解下這一用法。
定義屬性
要使用命名范圍功能,主要涉及到模型類的
_scope屬性定義和
scope連貫操作方法的使用。
我們首先定義_scope屬性:
class NewsModel extends Model {
protected $_scope = array(
// 命名范圍normal
'normal'=>array(
'where'=>array('status'=>1),
),
// 命名范圍latest
'latest'=>array(
'order'=>'create_time DESC',
'limit'=>10,
),
);
}
_scope屬性是一個數組,每個數組項表示定義一個命名范圍,命名范圍的定義格式為:
'命名范圍標識'=>array(
'屬性1'=>'值1',
'屬性2'=>'值2',
...
)
命名范圍標識:可以是任意的字符串,用于標識當前定義的命名范圍。
命名范圍支持的屬性包括:
where | 查詢條件 |
field | 查詢字段 |
order | 結果排序 |
table | 查詢表名 |
limit | 結果限制 |
page | 結果分頁 |
having | having查詢 |
group | group查詢 |
lock | 查詢鎖定 |
distinct | 唯一查詢 |
cache | 查詢緩存 |
每個命名范圍的定義可以包括這些屬性中一個或者多個。
方法調用
屬性定義完成后,接下來就是使用
scope方法進行命名范圍的調用了,每調用一個命名范圍,就相當于執行了命名范圍中定義的相關操作選項。
調用某個命名范圍
最簡單的調用方式就直接調用某個命名范圍,例如:
$Model = D('News'); // 這里必須使用D方法 因為命名范圍在模型里面定義
$Model->scope('normal')->select();
$Model->scope('latest')->select();
生成的SQL語句分別是:
SELECT * FROM think_news WHERE status=1
SELECT * FROM think_news ORDER BY create_time DESC LIMIT 10
調用多個命名范圍
也可以支持同時調用多個命名范圍定義,例如:
$Model->scope('normal')->scope('latest')->select();
或者簡化為:
$Model->scope('normal,latest')->select();
生成的SQL都是:
SELECT * FROM think_news WHERE status=1 ORDER BY create_time DESC LIMIT 10
如果兩個命名范圍的定義存在沖突,則后面調用的命名范圍定義會覆蓋前面的相同屬性的定義。
如果調用的命名范圍標識不存在,則會忽略該命名范圍,例如:
$Model->scope('normal,new')->select();
上面的命名范圍中new是不存在的,因此只有normal命名范圍生效,生成的SQL語句是:
SELECT * FROM think_news WHERE status=1
默認命名范圍
系統支持默認命名范圍功能,如果你定義了一個default命名范圍,例如:
protected $_scope = array(
// 默認的命名范圍
'default'=>array(
'where'=>array('status'=>1),
'limit'=>10,
),
);
那么調用default命名范圍可以直接使用:
$Model->scope()->select();
而無需再傳入命名范圍標識名
$Model->scope('default')->select();
雖然這兩種方式是等效的。
命名范圍調整
如果你需要在normal命名范圍的基礎上增加額外的調整,可以使用:
$Model->scope('normal',array('limit'=>5))->select();
生成的SQL語句是:
SELECT * FROM think_news WHERE status=1 LIMIT 5
當然,也可以在兩個命名范圍的基礎上進行調整,例如:
$Model->scope('normal,latest',array('limit'=>5))->select();
生成的SQL是:
SELECT * FROM think_news WHERE status=1 ORDER BY create_time DESC LIMIT 5
自定義命名范圍
又或者,干脆不用任何現有的命名范圍,我直接傳入一個命名范圍:
$Model->scope(array('field'=>'id,title','limit'=>5,'where'=>'status=1','order'=>'create_time DESC'))->select();
這樣,生成的SQL變成:
SELECT id,title FROM think_news WHERE status=1 ORDER BY create_time DESC LIMIT 5
與連貫操作混合使用
命名范圍一樣可以和之前的連貫操作混合使用,例如定義了命名范圍_scope屬性:
protected $_scope = array(
'normal'=>array(
'where'=>array('status'=>1),
'field'=>'id,title',
'limit'=>10,
),
);
然后在使用的時候,可以這樣調用:
$Model->scope('normal')->limit(8)->order('id desc')->select();
這樣,生成的SQL變成:
SELECT id,title FROM think_news WHERE status=1 ORDER BY id desc LIMIT 8
如果定義的命名范圍和連貫操作的屬性有沖突,則后面調用的會覆蓋前面的。
如果是這樣調用:
$Model->limit(8)->scope('normal')->order('id desc')->select();
生成的SQL則是:
SELECT id,title FROM think_news WHERE status=1 ORDER BY id desc LIMIT 10
總結
命名范圍功能的優勢在于可以一次定義多次調用,并且在項目中也能起到分工配合的規范,避免開發人員在寫CURD操作的時候出現問題,項目經理只需要合理的規劃命名范圍即可。