查询

版本	调整功能
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;
						
					

如果你是在模型内部，请不要使用$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('[email protected]');
						
					

通过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    =
							'[email protected]'; $user->save();
							// 从主库读取数据
							$user->master()->get($user->id);
						
					

V5.0.19+版本开始，你可以在数据库配置文件中设置

						
							// 主库写入后从主从库读取
							'read_master'
							=>
							true
						
					

设置开启后，一旦你的模型写入数据，那么该请求后续的模型读取操作都会自动读取主库。

或者可以在你完成主库写入操作后，执行下模型类的readMaster方法

						$user           =
							new
							User; $user->name     =
							'thinkphp'; $user->email    =
							'[email protected]'; $user->readMaster()->save();
							// 后续该模型的操作从主库读取数据
						
					

也可以支持后续所有模型的查询都在主库

						$user           =
							new
							User; $user->name     =
							'thinkphp'; $user->email    =
							'[email protected]'; $user->readMaster(true)->save();
							// 后续该模型的操作从主库读取数据
						
					

注意上述设置和方法仅对模型查询有效，直接调用Db类查询无效。