獲取單個數據

獲取單個數(shu)據的方法包(bao)括：

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

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

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

如果你是在模型內部，請不要使用$this->name的方式來獲取數據，請使用$this->getAttr('name') 替代。

或者在實例化模(mo)型后調用(yong)查詢方法

$user = new User();
// 查詢(xun)單個數據
$user->where('name', 'thinkphp')
    ->find();

get或者find方(fang)法返回(hui)的是當前(qian)模型的對(dui)象(xiang)實例，可以使用(yong)模型的方(fang)法。

獲取多個數據

取出多(duo)個數據：

// 根據(ju)主鍵獲取多個數據(ju)
$list = User::all('1,2,3');
// 或者使用數(shu)組
$list = User::all([1,2,3]);
foreach($list as $key=>$user){
    echo $user->name;
}
// 使用數組查詢
$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;
}

數(shu)(shu)組(zu)方式和閉包(bao)方式的數(shu)(shu)據(ju)查(cha)詢的區別在于，數(shu)(shu)組(zu)方式只能定義查(cha)詢條(tiao)件，閉包(bao)方式可(ke)以(yi)支持更(geng)多的連(lian)貫操作，包(bao)括排(pai)序(xu)、數(shu)(shu)量限(xian)制(zhi)等。

或(huo)者在實例化模型后(hou)調用查詢方法(fa)

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

模型的all方法或者select方(fang)法返回的是一個包含(han)模型對象(xiang)的二維數(shu)組或者數(shu)據集對象(xiang)。

自定義數據集對象

V5.0.4+版(ban)本開始，支持在模型中單獨設置(zhi)查(cha)詢數據集的(de)返(fan)回(hui)對象的(de)名稱（默認是數組），例如：

<?php
namespace app\index\model;

use think\Model;

class User extends Model
{
	// 設置返回數據集(ji)的對象名
	protected $resultSetType = 'collection';
}

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

獲取某個字段或者某個列的值

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

注意value和column方法返回的(de)(de)不再是一個模型(xing)對象實例，而是單純的(de)(de)值或者某個列的(de)(de)數(shu)組(zu)。

動態查詢

支持動態查詢(xun)方法，例如：

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

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

通過Query類查詢

或者使用(yong)數據庫(ku)的查詢方法進(jin)行更復雜的查詢：

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

可以在模型中直接使用所(suo)有數據庫(ku)的鏈式操作方法。

返回的查(cha)詢結果是當前模型(xing)(xing)對(dui)(dui)應的對(dui)(dui)象或(huo)者包含模型(xing)(xing)對(dui)(dui)象的數據集。

數據分批處理

模型也可以支持對返回的數據(ju)分(fen)批(pi)處(chu)理，這在(zai)處(chu)理大量(liang)數據(ju)的時候非常(chang)有用(yong)，例(li)如：

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

更多的(de)分批處理用法，可以參(can)考(kao)數(shu)據庫(ku)的(de)查詢數(shu)據部分。

查詢緩存

get方法和all方法的第三個(ge)參數表示是否使(shi)用查詢(xun)緩(huan)存，或者設置緩(huan)存標識。

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

由于第二個參數是關聯預載入定義，V5.0.6+版本開(kai)始，可以直接在第二個(ge)參(can)數傳入(ru)true表示(shi)開(kai)啟查詢緩存。

主庫讀取

如果你采(cai)用分(fen)布式數(shu)(shu)據(ju)(ju)庫(ku)，如果寫入數(shu)(shu)據(ju)(ju)后(hou)立刻(ke)進行該數(shu)(shu)據(ju)(ju)的讀取，將會導(dao)致數(shu)(shu)據(ju)(ju)讀取失敗，原因是數(shu)(shu)據(ju)(ju)庫(ku)同(tong)步尚未(wei)完成。

規范的解決方案是在寫入數據后，不要馬上從從庫讀取，而應該調用master方法讀取主庫。

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

V5.0.19+版本開始，你可以在數(shu)據庫配置(zhi)文(wen)件(jian)中設置(zhi)

// 主(zhu)庫寫入后從(cong)(cong)主(zhu)從(cong)(cong)庫讀(du)取(qu)
'read_master'	=> true

設置開啟后(hou)，一旦你的模(mo)(mo)型寫入數據，那么該(gai)請求后(hou)續的模(mo)(mo)型讀取操作都會自動(dong)讀取主(zhu)庫。

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

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

也(ye)可以(yi)支持(chi)后續(xu)所有模型的查詢(xun)都在(zai)主庫

$user           = new User;
$user->name     = 'thinkphp';
$user->email    = 'thinkphp@qq.com';
$user->readMaster(true)->save();
// 后(hou)續該模(mo)型的(de)操作從主(zhu)庫(ku)讀(du)取數據

注意上述(shu)設(she)置和方(fang)法僅對模型查詢有效(xiao)(xiao)，直接調用Db類查詢無(wu)效(xiao)(xiao)。