ThinkPHP3.1中的命名范圍是什么

這篇文章給大家介紹ThinkPHP3.1中的命名范圍是什么，內(nèi)容非常詳細(xì)，感興趣的小伙伴們可以參考借鑒，希望對(duì)大家能有所幫助。

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

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屬性是一個(gè)數(shù)組，每個(gè)數(shù)組項(xiàng)表示定義一個(gè)命名范圍，命名范圍的定義格式為：

'命名范圍標(biāo)識(shí)'=>array(
  '屬性1'=>'值1',
  '屬性2'=>'值2',
  ...
 )

2.命名范圍標(biāo)識(shí)：可以是任意的字符串，用于標(biāo)識(shí)當(dāng)前定義的命名范圍。

命名范圍支持的屬性包括：

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

3.方法調(diào)用

屬性定義完成后，接下來(lái)就是使用scope方法進(jìn)行命名范圍的調(diào)用了，每調(diào)用一個(gè)命名范圍，就相當(dāng)于執(zhí)行了命名范圍中定義的相關(guān)操作選項(xiàng)。

調(diào)用某個(gè)命名范圍

最簡(jiǎn)單的調(diào)用方式就直接調(diào)用某個(gè)命名范圍，例如：

$Model = D('News'); // 這里必須使用D方法 因?yàn)槊秶谀Ｐ屠锩娑x
$Model->scope('normal')->select();
$Model->scope('latest')->select();

生成的SQL語(yǔ)句分別是：

SELECT * FROM think_news WHERE status=1
SELECT * FROM think_news ORDER BY create_time DESC LIMIT 10

調(diào)用多個(gè)命名范圍

也可以支持同時(shí)調(diào)用多個(gè)命名范圍定義，例如：

$Model->scope('normal')->scope('latest')->select();

或者簡(jiǎn)化為：

$Model->scope('normal,latest')->select();

生成的SQL都是：

SELECT * FROM think_news WHERE status=1 ORDER BY create_time DESC LIMIT 10

如果兩個(gè)命名范圍的定義存在沖突，則后面調(diào)用的命名范圍定義會(huì)覆蓋前面的相同屬性的定義。
如果調(diào)用的命名范圍標(biāo)識(shí)不存在，則會(huì)忽略該命名范圍，例如：

$Model->scope('normal,new')->select();

上面的命名范圍中new是不存在的，因此只有normal命名范圍生效，生成的SQL語(yǔ)句是：

SELECT * FROM think_news WHERE status=1

4.默認(rèn)命名范圍

系統(tǒng)支持默認(rèn)命名范圍功能，如果你定義了一個(gè)default命名范圍，例如：

 protected $_scope = array(
    // 默認(rèn)的命名范圍
    'default'=>array(
      'where'=>array('status'=>1),
      'limit'=>10,
    ),
  );

那么調(diào)用default命名范圍可以直接使用：

$Model->scope()->select();

而無(wú)需再傳入命名范圍標(biāo)識(shí)名

$Model->scope('default')->select();

雖然這兩種方式是等效的。

命名范圍調(diào)整

如果你需要在normal命名范圍的基礎(chǔ)上增加額外的調(diào)整，可以使用：

$Model->scope('normal',array('limit'=>5))->select();

生成的SQL語(yǔ)句是：

SELECT * FROM think_news WHERE status=1 LIMIT 5

當(dāng)然，也可以在兩個(gè)命名范圍的基礎(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)有的命名范圍，我直接傳入一個(gè)命名范圍：

$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,
  ),
 );

然后在使用的時(shí)候，可以這樣調(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)用的會(huì)覆蓋前面的。
如果是這樣調(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

命名范圍功能的優(yōu)勢(shì)在于可以一次定義多次調(diào)用，并且在項(xiàng)目中也能起到分工配合的規(guī)范，避免開(kāi)發(fā)人員在寫CURD操作的時(shí)候出現(xiàn)問(wèn)題，項(xiàng)目經(jīng)理只需要合理的規(guī)劃命名范圍即可。

關(guān)于ThinkPHP3.1中的命名范圍是什么就分享到這里了，希望以上內(nèi)容可以對(duì)大家有一定的幫助，可以學(xué)到更多知識(shí)。如果覺(jué)得文章不錯(cuò)，可以把它分享出去讓更多的人看到。