|版本|调整功能| |---|---| |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类查询无效。