查詢

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

獲取單個數(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)部，請不要使用$this->name的方式來獲取數(shù)據(jù)，請使用$this->getAttr('name') 替代。

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

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

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

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

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

// 根據(jù)主鍵獲取多個數(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ù)量限制等。

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

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

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

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

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

<?php
namespace app\index\model;

use think\Model;

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

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

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

// 獲取某個用戶的積分
User::where('id',10)->value('score');
// 獲取某個列的所有值
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方法返回的不再是一個模型對象實例，而是單純的值或者某個列的數(shù)組。

動態(tài)查詢

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

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

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

通過Query類查詢

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

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

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

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

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

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

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

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

查詢緩存

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

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

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

主庫讀取

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

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

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

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

// 主庫寫入后從主從庫讀取
'read_master'	=> true

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

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

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

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

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

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