ThinkPHP3.1新特性之命名范圍的使用

ThinkPHP3.1的命名范圍功能，給模型操作提供了一系列的（連貫操作）封裝，讓你更方便的查詢和操作數據。下面我們就來具體了解下這一用法。

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屬性是一個數組，每個數組項表示定義一個命名范圍，命名范圍的定義格式為：

'命名范圍標識'=>array(
  '屬性1'=>'值1',
  '屬性2'=>'值2',
  ...
 )

2.命名范圍標識：可以是任意的字符串，用於標識當前定義的命名范圍。

命名范圍支持的屬性包括：
where 查詢條件 field 查詢字段 order 結果排序 table 查詢表名 limit 結果限制 page 結果分頁 having having查詢 group group查詢 lock 查詢鎖定 distinct 唯一查詢 cache 查詢緩存
 

每個命名范圍的定義可以包括這些屬性中一個或者多個。

3.方法調用

屬性定義完成後，接下來就是使用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

4.默認命名范圍

系統支持默認命名范圍功能，如果你定義了一個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

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操作的時候出現問題，項目經理只需要合理的規劃命名范圍即可。