6.16 命名范圍 · thinkphp3.1.2

# 命名范圍 [上一頁](69.html "上一頁")[下一頁](71.html "下一頁") 模型命名范圍功能，給模型操作提供了一系列的（連貫操作）封裝，讓你更方便的查詢和操作數據。#### 定義屬性要使用命名范圍功能，主要涉及到模型類的_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結果分頁havinghaving查詢groupgroup查詢lock查詢鎖定distinct唯一查詢cache查詢緩存每個命名范圍的定義可以包括這些屬性中一個或者多個。#### 方法調用屬性定義完成后，接下來就是使用**scope方法**進行命名范圍的調用了，每調用一個命名范圍，就相當于執行了命名范圍中定義的相關操作選項。#### 調用某個命名范圍最簡單的調用方式就直接調用某個命名范圍，例如：`$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操作的時候出現問題，項目經理只需要合理的規劃命名范圍即可。 [上一頁](69.html "上一頁")[下一頁](71.html "下一頁")