|版本|調整功能| |---|---| |5.0.19|模型增加`readMaster`方法用于后續都從主庫讀取| ## 獲取單個數據 獲取單個數據的方法包括： ~~~ 取出主鍵為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; ~~~ >[danger] 如果你是在模型內部，請不要使用`$this->name`的方式來獲取數據，請使用`$this->getAttr('name')` 替代。 或者在實例化模型后調用查詢方法 ~~~ $user = new User(); // 查詢單個數據 $user->where('name', 'thinkphp') ->find(); ~~~ > `get`或者`find`方法返回的是當前模型的對象實例，可以使用模型的方法。 ## 獲取多個數據 |版本|新增功能| |---|---| |5.0.4|支持在模型中設置`resultSetType`返回數據集對象的名稱| 取出多個數據： ~~~ // 根據主鍵獲取多個數據 $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模型對象 } }); ~~~ >[info] 更多的分批處理用法，可以參考數據庫的查詢數據部分。 ## 查詢緩存 `get`方法和`all`方法的第三個參數表示是否使用查詢緩存，或者設置緩存標識。 ~~~ $user = User::get(1,'',true); $list = User::all('1,2,3','',true); ~~~ >[danger] 由于第二個參數是關聯預載入定義，`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(); // 后續該模型的操作從主庫讀取數據 ~~~ >[danger] 注意上述設置和方法僅對模型查詢有效，直接調用Db類查詢無效。