基本查询

查询一个数据使用:

  1. // table方法必须指定完整的数据表名
  2. Db::table('think_user')->where('id',1)->find();
find 方法查询结果不存在,返回 null

查询数据集使用:

  1. Db::table('think_user')->where('status',1)->select();
select 方法查询结果不存在,返回空数组

如果设置了数据表前缀参数的话,可以使用

  1. Db::name('user')->where('id',1)->find();
  2. Db::name('user')->where('status',1)->select();
如果你的数据表没有使用表前缀功能,那么name和table方法的一样的效果。

findselect方法之前可以使用所有的链式操作方法。

默认情况下,find和select方法返回的都是数组。

主从查询

如果你使用了分布式数据库,那么默认情况下查询操作都是在从数据库中进行,如果你在一些特殊的情况下需要从主库读取数据,可以使用:

  1. $data = ['foo' => 'bar', 'bar' => 'foo'];
  2. Db::table('think_user')->insert($data);
  3. Db::name('user')->master()->where('id',1)->find();

V5.0.19+版本开始,支持一旦某个表写入了数据,那么当前请求的后续查询操作都可以自动从主库读取。

你需要在数据库配置文件中增加下面的配置参数:

  1. // 从主库读取数据
  2. 'read_master' => true,

如果你只需要对某个表进行操作,可以使用readMaster方法。

  1. $data = ['foo' => 'bar', 'bar' => 'foo'];
  2. Db::table('think_user')
  3. ->readMaster()
  4. ->insert($data);
  5. // 后续所有关于该数据表的查询都会走主库

也可以让后续所有数据表的查询都走主库

  1. $data = ['foo' => 'bar', 'bar' => 'foo'];
  2. Db::table('think_user')
  3. ->readMaster(true)
  4. ->insert($data);
  5. // 后续所有数据表的查询都会走主库

助手函数

系统提供了一个db助手函数,可以更方便的查询:

  1. db('user')->where('id',1)->find();
  2. db('user')->where('status',1)->select();
注意:使用db助手函数默认每次都会重新连接数据库,而使用Db::name或者Db::table方法的话都是单例的。db函数如果需要采用相同的链接,可以传入第三个参数,例如:

  1. db('user',[],false)->where('id',1)->find();
    db('user',[],false)->where('status',1)->select();


上面的方式会使用同一个数据库连接,第二个参数为数据库的连接参数,留空表示采用数据库配置文件的配置。
版本调整功能
5.0.9db助手函数默认不再强制重新连接

使用Query对象或闭包查询

或者使用查询对象进行查询,例如:

  1. $query = new \think\db\Query();
  2. $query->table('think_user')->where('status',1);
  3. Db::find($query);
  4. Db::select($query);

或者直接使用闭包函数查询,例如:

  1. Db::select(function($query){
  2. $query->table('think_user')->where('status',1);
  3. });

值和列查询

查询某个字段的值可以用

  1. // 返回某个字段的值
  2. Db::table('think_user')->where('id',1)->value('name');
value 方法查询结果不存在,返回 null

查询某一列的值可以用

  1. // 返回数组
  2. Db::table('think_user')->where('status',1)->column('name');
  3. // 指定索引
  4. Db::table('think_user')->where('status',1)->column('name','id');
  5. Db::table('think_user')->where('status',1)->column('id,name'); // 同tp3的getField
column 方法查询结果不存在,返回空数组

数据集分批处理

如果你需要处理成千上百条数据库记录,可以考虑使用chunk方法,该方法一次获取结果集的一小块,然后填充每一小块数据到要处理的闭包,该方法在编写处理大量数据库记录的时候非常有用。

比如,我们可以全部用户表数据进行分批处理,每次处理 100 个用户记录:

  1. Db::table('think_user')->chunk(100, function($users) {
  2. foreach ($users as $user) {
  3. //
  4. }
  5. });
  6. // 或者交给回调方法myUserIterator处理
  7. Db::table('think_user')->chunk(100, 'myUserIterator');

你可以通过从闭包函数中返回false来中止对数据集的处理:

  1. Db::table('think_user')->chunk(100, function($users) {
  2. // 处理结果集...
  3. return false;
  4. });

也支持在chunk方法之前调用其它的查询方法,例如:

  1. Db::table('think_user')->where('score','>',80)->chunk(100, function($users) {
  2. foreach ($users as $user) {
  3. //
  4. }
  5. });

chunk方法的处理默认是根据主键查询,支持指定字段,例如:

  1. Db::table('think_user')->chunk(100, function($users) {
  2. // 处理结果集...
  3. return false;
  4. },'create_time');
V5.0.11版本开始,chunk方法支持指定处理数据的顺序。
  1. Db::table('think_user')->chunk(100, function($users) {
  2. // 处理结果集...
  3. return false;
  4. },'create_time', 'desc');

JSON类型数据查询(mysql V5.0.1)

  1. // 查询JSON类型字段 (info字段为json类型)
  2. Db::table('think_user')->where('info$.email','thinkphp@qq.com')->find();