獲取單個數據

獲取單個數據的方法包括：

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

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

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

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

或者在實例化模型后調用查詢方法

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

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

獲取多個數據

取出多個數據：

// 根據主鍵獲取多個數據
$list = User::all('1,2,3');
// 或者使用數組
$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;
}

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

或者在實例化模型后調用查詢方法

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

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

自定義數據集對象

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

<?php
namespace app\index\model;

use think\Model;

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

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

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

// 獲取某個用戶的積分
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方法返回的不再是一個模型對象實例，而是單純的值或者某個列的數組。

動態查詢

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

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

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

通過Query類查詢

或者使用數據庫的查詢方法進行更復雜的查詢：

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

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

返回的查詢結果是當前模型對應的對象或者包含模型對象的數據集。

數據分批處理

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

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

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

查詢緩存

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

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

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

主庫讀取

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

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

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

V5.0.19+版本開始，你可以在數據庫配置文件中設置

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

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

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

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

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

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

注意上述設置和方法僅對模型查詢有效，直接調用Db類查詢無效。