💎一站式轻松地调用各大LLM模型接口,支持GPT4、智谱、星火、月之暗面及文生图 广告
## 基本查询 查询一个数据使用: ~~~ // table方法必须指定完整的数据表名 Db::table('think_user')->where('id',1)->find(); ~~~ > find 方法查询结果不存在,返回 null 查询数据集使用: ~~~ Db::table('think_user')->where('status',1)->select(); ~~~ > select 方法查询结果不存在,返回空数组 如果设置了数据表前缀参数的话,可以使用 ~~~ Db::name('user')->where('id',1)->find(); Db::name('user')->where('status',1)->select(); ~~~ > 如果你的数据表没有使用表前缀功能,那么name和table方法的一样的效果。 在`find`和`select`方法之前可以使用所有的链式操作方法。 > 默认情况下,find和select方法返回的都是数组。 ### 主从查询 如果你使用了分布式数据库,那么默认情况下查询操作都是在从数据库中进行,如果你在一些特殊的情况下需要从主库读取数据,可以使用: ~~~ $data = ['foo' => 'bar', 'bar' => 'foo']; Db::table('think_user')->insert($data); Db::name('user')->master()->where('id',1)->find(); ~~~ `V5.0.19+`版本开始,支持一旦某个表写入了数据,那么当前请求的后续查询操作都可以自动从主库读取。 你需要在数据库配置文件中增加下面的配置参数: ~~~ // 从主库读取数据 'read_master' => true, ~~~ 如果你只需要对某个表进行操作,可以使用`readMaster`方法。 ~~~ $data = ['foo' => 'bar', 'bar' => 'foo']; Db::table('think_user') ->readMaster() ->insert($data); // 后续所有关于该数据表的查询都会走主库 ~~~ 也可以让后续所有数据表的查询都走主库 ~~~ $data = ['foo' => 'bar', 'bar' => 'foo']; Db::table('think_user') ->readMaster(true) ->insert($data); // 后续所有数据表的查询都会走主库 ~~~ ### 助手函数 系统提供了一个`db`助手函数,可以更方便的查询: ~~~ db('user')->where('id',1)->find(); db('user')->where('status',1)->select(); ~~~ >[danger] 注意:使用db助手函数默认每次都会重新连接数据库,而使用`Db::name`或者`Db::table`方法的话都是单例的。db函数如果需要采用相同的链接,可以传入第三个参数,例如: > ~~~ > db('user',[],false)->where('id',1)->find(); > db('user',[],false)->where('status',1)->select(); > ~~~ > 上面的方式会使用同一个数据库连接,第二个参数为数据库的连接参数,留空表示采用数据库配置文件的配置。 | 版本 | 调整功能 | | --- | --- | | 5.0.9 | db助手函数默认不再强制重新连接 | ## 使用Query对象或闭包查询 或者使用查询对象进行查询,例如: ~~~ $query = new \think\db\Query(); $query->table('think_user')->where('status',1); Db::find($query); Db::select($query); ~~~ 或者直接使用闭包函数查询,例如: ~~~ Db::select(function($query){ $query->table('think_user')->where('status',1); }); ~~~ ## 值和列查询 查询某个字段的值可以用 ~~~ // 返回某个字段的值 Db::table('think_user')->where('id',1)->value('name'); ~~~ > value 方法查询结果不存在,返回 null 查询某一列的值可以用 ~~~ // 返回数组 Db::table('think_user')->where('status',1)->column('name'); // 指定索引 Db::table('think_user')->where('status',1)->column('name','id'); Db::table('think_user')->where('status',1)->column('id,name'); // 同tp3的getField ~~~ > column 方法查询结果不存在,返回空数组 ## 数据集分批处理 如果你需要处理成千上百条数据库记录,可以考虑使用chunk方法,该方法一次获取结果集的一小块,然后填充每一小块数据到要处理的闭包,该方法在编写处理大量数据库记录的时候非常有用。 比如,我们可以全部用户表数据进行分批处理,每次处理 100 个用户记录: ~~~ Db::table('think_user')->chunk(100, function($users) { foreach ($users as $user) { // } }); // 或者交给回调方法myUserIterator处理 Db::table('think_user')->chunk(100, 'myUserIterator'); ~~~ 你可以通过从闭包函数中返回false来中止对数据集的处理: ~~~ Db::table('think_user')->chunk(100, function($users) { // 处理结果集... return false; }); ~~~ 也支持在chunk方法之前调用其它的查询方法,例如: ~~~ Db::table('think_user')->where('score','>',80)->chunk(100, function($users) { foreach ($users as $user) { // } }); ~~~ chunk方法的处理默认是根据主键查询,支持指定字段,例如: ~~~ Db::table('think_user')->chunk(100, function($users) { // 处理结果集... return false; },'create_time'); ~~~ >[info] `V5.0.11`版本开始,chunk方法支持指定处理数据的顺序。 ~~~ Db::table('think_user')->chunk(100, function($users) { // 处理结果集... return false; },'create_time', 'desc'); ~~~ ## JSON类型数据查询(mysql `V5.0.1`) ~~~ // 查询JSON类型字段 (info字段为json类型) Db::table('think_user')->where('info$.email','thinkphp@qq.com')->find(); ~~~