查詢

獲取單個(gè)數(shù)據(jù)

獲取單個(gè)數(shù)據(jù)的方法包括：

取出主鍵為1的數(shù)據(jù)
$user = User::get(1);
echo $user->name;

// 使用數(shù)組查詢
$user = User::get(['name' => 'thinkphp']);

// 使用閉包查詢
$user = User::get(function($query){
    $query->where('name', 'thinkphp');
});
echo $user->name;

如果你是在模型內(nèi)部，請(qǐng)不要使用$this->name的方式來(lái)獲取數(shù)據(jù)，請(qǐng)使用$this->getAttr('name') 替代。

或者在實(shí)例化模型后調(diào)用查詢方法

$user = new User();
// 查詢單個(gè)數(shù)據(jù)
$user->where('name', 'thinkphp')
    ->find();

get或者find方法返回的是當(dāng)前模型的對(duì)象實(shí)例，可以使用模型的方法。

獲取多個(gè)數(shù)據(jù)

取出多個(gè)數(shù)據(jù)：

// 根據(jù)主鍵獲取多個(gè)數(shù)據(jù)
$list = User::all('1,2,3');
// 或者使用數(shù)組
$list = User::all([1,2,3]);
foreach($list as $key=>$user){
    echo $user->name;
}
// 使用數(shù)組查詢
$list = User::all(['status'=>1]);
// 使用閉包查詢
$list = User::all(function($query){
    $query->where('status', 1)->limit(3)->order('id', 'asc');
});
foreach($list as $key=>$user){
    echo $user->name;
}

數(shù)組方式和閉包方式的數(shù)據(jù)查詢的區(qū)別在于，數(shù)組方式只能定義查詢條件，閉包方式可以支持更多的連貫操作，包括排序、數(shù)量限制等。

或者在實(shí)例化模型后調(diào)用查詢方法

$user = new User();
// 查詢數(shù)據(jù)集
$user->where('name', 'thinkphp')
    ->limit(10)
    ->order('id', 'desc')
    ->select();

模型的all方法或者select方法返回的是一個(gè)包含模型對(duì)象的二維數(shù)組或者數(shù)據(jù)集對(duì)象。

自定義數(shù)據(jù)集對(duì)象

V5.0.4+版本開(kāi)始，支持在模型中單獨(dú)設(shè)置查詢數(shù)據(jù)集的返回對(duì)象的名稱（默認(rèn)是數(shù)組），例如：

<?php
namespace app\index\model;

use think\Model;

class User extends Model
{
	// 設(shè)置返回?cái)?shù)據(jù)集的對(duì)象名
	protected $resultSetType = 'collection';
}

resultSetType字段如果為空則使用數(shù)組作為數(shù)據(jù)集返回類型，如果設(shè)置為collection則表示使用think\Collection作為返回對(duì)象名，也可以設(shè)置自定義的數(shù)據(jù)集對(duì)象名稱（使用完整的命名空間定義）。

獲取某個(gè)字段或者某個(gè)列的值

// 獲取某個(gè)用戶的積分
User::where('id',10)->value('score');
// 獲取某個(gè)列的所有值
User::where('status',1)->column('name');
// 以id為索引
User::where('status',1)->column('name','id');
User::where('status',1)->column('id,name'); // 同tp3的getField

注意value和column方法返回的不再是一個(gè)模型對(duì)象實(shí)例，而是單純的值或者某個(gè)列的數(shù)組。

動(dòng)態(tài)查詢

支持動(dòng)態(tài)查詢方法，例如：

// 根據(jù)name字段查詢用戶
$user = User::getByName('thinkphp');

// 根據(jù)email字段查詢用戶
$user = User::getByEmail('thinkphp@qq.com');

通過(guò)Query類查詢

或者使用數(shù)據(jù)庫(kù)的查詢方法進(jìn)行更復(fù)雜的查詢：

User::where('id','>',10)->select();
User::where('name','thinkphp')->find();

可以在模型中直接使用所有數(shù)據(jù)庫(kù)的鏈?zhǔn)讲僮鞣椒ā?/p>

返回的查詢結(jié)果是當(dāng)前模型對(duì)應(yīng)的對(duì)象或者包含模型對(duì)象的數(shù)據(jù)集。

數(shù)據(jù)分批處理

模型也可以支持對(duì)返回的數(shù)據(jù)分批處理，這在處理大量數(shù)據(jù)的時(shí)候非常有用，例如：

User::chunk(100,function($users){
    foreach($users as $user){
        // 處理user模型對(duì)象
    }
});

更多的分批處理用法，可以參考數(shù)據(jù)庫(kù)的查詢數(shù)據(jù)部分。

查詢緩存

get方法和all方法的第三個(gè)參數(shù)表示是否使用查詢緩存，或者設(shè)置緩存標(biāo)識(shí)。

$user = User::get(1,'',true);
$list  = User::all('1,2,3','',true);

由于第二個(gè)參數(shù)是關(guān)聯(lián)預(yù)載入定義，V5.0.6+版本開(kāi)始，可以直接在第二個(gè)參數(shù)傳入true表示開(kāi)啟查詢緩存。

主庫(kù)讀取

如果你采用分布式數(shù)據(jù)庫(kù)，如果寫入數(shù)據(jù)后立刻進(jìn)行該數(shù)據(jù)的讀取，將會(huì)導(dǎo)致數(shù)據(jù)讀取失敗，原因是數(shù)據(jù)庫(kù)同步尚未完成。

規(guī)范的解決方案是在寫入數(shù)據(jù)后，不要馬上從從庫(kù)讀取，而應(yīng)該調(diào)用master方法讀取主庫(kù)。

$user           = new User;
$user->name     = 'thinkphp';
$user->email    = 'thinkphp@qq.com';
$user->save();
// 從主庫(kù)讀取數(shù)據(jù)
$user->master()->get($user->id);

V5.0.19+版本開(kāi)始，你可以在數(shù)據(jù)庫(kù)配置文件中設(shè)置

// 主庫(kù)寫入后從主從庫(kù)讀取
'read_master'	=> true

設(shè)置開(kāi)啟后，一旦你的模型寫入數(shù)據(jù)，那么該請(qǐng)求后續(xù)的模型讀取操作都會(huì)自動(dòng)讀取主庫(kù)。

或者可以在你完成主庫(kù)寫入操作后，執(zhí)行下模型類的readMaster方法

$user           = new User;
$user->name     = 'thinkphp';
$user->email    = 'thinkphp@qq.com';
$user->readMaster()->save();
// 后續(xù)該模型的操作從主庫(kù)讀取數(shù)據(jù)

也可以支持后續(xù)所有模型的查詢都在主庫(kù)

$user           = new User;
$user->name     = 'thinkphp';
$user->email    = 'thinkphp@qq.com';
$user->readMaster(true)->save();
// 后續(xù)該模型的操作從主庫(kù)讀取數(shù)據(jù)

注意上述設(shè)置和方法僅對(duì)模型查詢有效，直接調(diào)用Db類查詢無(wú)效。