查询
最后更新于：2022-04-01 21:22:16
|版本|调整功能|
|---|---|
|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+`版本开始，支持在模型中单独设置查询数据集的返回对象的名称（默认是数组），例如：
~~~
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类查询无效。
';