ThinkPHP3.1新特性之命名范圍的使用
ThinkPHP3.1的命名范圍功能，給模型操作提供了一系列的（連貫操作）封裝，讓你更方便的查詢和操作數(shù)據(jù)。下面我們就來具體了解下這一用法。
1.定義屬性
要使用命名范圍功能，主要涉及到模型類的_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屬性是一個數(shù)組，每個數(shù)組項表示定義一個命名范圍，命名范圍的定義格式為：
'命名范圍標(biāo)識'=>array( '屬性1'=>'值1', '屬性2'=>'值2', ... )
2.命名范圍標(biāo)識：可以是任意的字符串，用于標(biāo)識當(dāng)前定義的命名范圍。
命名范圍支持的屬性包括：
| where | 查詢條件 |
| field | 查詢字段 |
| order | 結(jié)果排序 |
| table | 查詢表名 |
| limit | 結(jié)果限制 |
| page | 結(jié)果分頁 |
| having | having查詢 |
| group | group查詢 |
| lock | 查詢鎖定 |
| distinct | 唯一查詢 |
| cache | 查詢緩存 |
每個命名范圍的定義可以包括這些屬性中一個或者多個。
3.方法調(diào)用
屬性定義完成后，接下來就是使用scope方法進(jìn)行命名范圍的調(diào)用了，每調(diào)用一個命名范圍，就相當(dāng)于執(zhí)行了命名范圍中定義的相關(guān)操作選項。
調(diào)用某個命名范圍
最簡單的調(diào)用方式就直接調(diào)用某個命名范圍，例如：
$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
調(diào)用多個命名范圍
也可以支持同時調(diào)用多個命名范圍定義，例如：
$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
如果兩個命名范圍的定義存在沖突，則后面調(diào)用的命名范圍定義會覆蓋前面的相同屬性的定義。
如果調(diào)用的命名范圍標(biāo)識不存在，則會忽略該命名范圍，例如：
$Model->scope('normal,new')->select();
上面的命名范圍中new是不存在的，因此只有normal命名范圍生效，生成的SQL語句是：
SELECT * FROM think_news WHERE status=1
4.默認(rèn)命名范圍
系統(tǒng)支持默認(rèn)命名范圍功能，如果你定義了一個default命名范圍，例如：
protected $_scope = array(
// 默認(rèn)的命名范圍
'default'=>array(
'where'=>array('status'=>1),
'limit'=>10,
),
);
那么調(diào)用default命名范圍可以直接使用：
$Model->scope()->select();
而無需再傳入命名范圍標(biāo)識名
$Model->scope('default')->select();
雖然這兩種方式是等效的。
命名范圍調(diào)整
如果你需要在normal命名范圍的基礎(chǔ)上增加額外的調(diào)整，可以使用：
$Model->scope('normal',array('limit'=>5))->select();
生成的SQL語句是：
SELECT * FROM think_news WHERE status=1 LIMIT 5
當(dāng)然，也可以在兩個命名范圍的基礎(chǔ)上進(jìn)行調(diào)整，例如：
$Model->scope('normal,latest',array('limit'=>5))->select();
生成的SQL是：
SELECT * FROM think_news WHERE status=1 ORDER BY create_time DESC LIMIT 5
自定義命名范圍
又或者，干脆不用任何現(xiàn)有的命名范圍，我直接傳入一個命名范圍：
$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
5.與連貫操作混合使用
命名范圍一樣可以和之前的連貫操作混合使用，例如定義了命名范圍_scope屬性：
protected $_scope = array(
'normal'=>array(
'where'=>array('status'=>1),
'field'=>'id,title',
'limit'=>10,
),
);
然后在使用的時候，可以這樣調(diào)用：
$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
如果定義的命名范圍和連貫操作的屬性有沖突，則后面調(diào)用的會覆蓋前面的。
如果是這樣調(diào)用：
$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
總結(jié)
命名范圍功能的優(yōu)勢在于可以一次定義多次調(diào)用，并且在項目中也能起到分工配合的規(guī)范，避免開發(fā)人員在寫CURD操作的時候出現(xiàn)問題，項目經(jīng)理只需要合理的規(guī)劃命名范圍即可。
- 使用Thinkphp框架開發(fā)移動端接口
- ThinkPHP的MVC開發(fā)機(jī)制實例解析
- 最新制作ThinkPHP3.2.3完全開發(fā)手冊
- ThinkPHP的SAE開發(fā)相關(guān)注意事項詳解
- thinkphp的URL路由規(guī)則與配置實例
- thinkphp路由規(guī)則使用示例詳解和偽靜態(tài)功能實現(xiàn)(apache重寫)
- thinkPHP5.0框架安裝教程
- thinkPHP5.0框架應(yīng)用請求生命周期分析
- thinkPHP5.0框架URL訪問方法詳解
- thinkPHP5.0框架命名空間詳解
- thinkPHP5.0框架自動加載機(jī)制分析
- thinkPHP5.0框架配置格式、加載解析與讀取方法
- thinkPHP5.0框架獨(dú)立配置與動態(tài)配置方法
- thinkPHP5.0框架環(huán)境變量配置方法
- thinkPHP5.0框架開發(fā)規(guī)范簡介
相關(guān)文章
Laravel框架基于中間件實現(xiàn)禁止未登錄用戶訪問頁面功能示例
這篇文章主要介紹了Laravel框架基于中間件實現(xiàn)禁止未登錄用戶訪問頁面功能,結(jié)合實例形式分析了Laravel框架中間件生成、注冊及使用相關(guān)操作技巧,需要的朋友可以參考下2019-01-01
php學(xué)習(xí)Eloquent修改器源碼示例解析
這篇文章主要為大家介紹了php學(xué)習(xí)Eloquent修改器源碼示例解析，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪2023-06-06
本篇文章是對php-fpm參數(shù)進(jìn)行了詳細(xì)的分析介紹，需要的朋友參考下2013-06-06
這篇文章主要介紹了Yii實現(xiàn)自動加載類地圖的方法,涉及Yii加載類的技巧,具有一定參考借鑒價值,需要的朋友可以參考下2015-04-04
這篇文章主要介紹了PHP生成自定義長度隨機(jī)字符串的函數(shù)分享,需要的朋友可以參考下2014-05-05
這篇文章主要給大家介紹了關(guān)于PHP連接sftp并下載文件的相關(guān)資料,需要的朋友可以參考下2018-08-08
這篇文章主要為大家詳細(xì)介紹了php微信公眾號開發(fā)之答題連闖三關(guān)，具有一定的參考價值，感興趣的小伙伴們可以參考一下2018-10-10
php寫app接口并返回json數(shù)據(jù)的實例(分享)
下面小編就為大家?guī)硪黄猵hp寫app接口并返回json數(shù)據(jù)的實例(分享)。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-05-05
今天小編就為大家分享一篇laravel 實現(xiàn)登陸后返回登陸前的頁面方法，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2019-10-10
這篇文章主要介紹了YII關(guān)聯(lián)查詢的相關(guān)資料,需要的朋友可以參考下2016-01-01