程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> PHP綜合 >> ThinkPHP3.1新特性之命名范圍的使用

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

編輯:PHP綜合

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

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved