高级查询

引入类：

use think\facade\Db;

快捷查询

快捷查询是一种简化多字段相同查询条件写法的方式。在多个字段之间用|分割表示OR查询，用&分割表示AND查询。示例如下：

Db::table('think_user')
    ->where('name|title', 'like', 'thinkphp%')
    ->where('create_time&update_time', '>', 0)
    ->find();

生成的查询SQL是：

SELECT * FROM `think_user` WHERE ( `name` LIKE 'thinkphp%' OR `title` LIKE 'thinkphp%' ) AND ( `create_time` > 0 AND `update_time` > 0 ) LIMIT 1

快捷查询支持所有的查询表达式。

枚举查询

若数据字段使用了枚举类型并定义了枚举类StatusEnum，可以这样使用：

Db::table('think_user')
    ->where('status', StatusEnum::Normal)
    ->find();

会自动将枚举值转换为对应的value值进行写入。

批量（字段）查询

可以进行多个条件的批量条件查询定义，例如：

Db::table('think_user')
    ->where([
        ['name', 'like', 'thinkphp%'],
        ['title', 'like', '%thinkphp'],
        ['id', '>', 0],
        ['status', '=', 1],
    ])
    ->select();

生成的SQL语句为：

SELECT * FROM `think_user` WHERE `name` LIKE 'thinkphp%' AND `title` LIKE '%thinkphp' AND `id` > 0 AND `status` = '1'

数组方式如果使用exp查询，一定要用raw方法，示例如下：

Db::table('think_user')
    ->where([
        ['name', 'like', 'thinkphp%'],
        ['title', 'like', '%thinkphp'],
        ['id', 'exp', Db::raw('>score')],
        ['status', '=', 1],
    ])
    ->select();

数组查询方式要确保查询数组不被用户提交数据控制，用户提交的表单数据应作为查询数组的一个元素传入，如下：

Db::table('think_user')
    ->where([
        ['name', 'like', $name . '%'],
        ['title', 'like', '%' . $title],
        ['id', '>', $id],
        ['status', '=', $status],
    ])
    ->select();

若希望某一个where方法里的条件单独处理，避免被其它条件影响，可以使用如下方式：

$map = [
    ['name', 'like', 'thinkphp%'],
    ['title', 'like', '%thinkphp'],
    ['id', '>', 0],
];
Db::table('think_user')
    ->where([ $map ])
    ->where('status', 1)
    ->select();

生成的SQL语句为：

SELECT * FROM `think_user` WHERE ( `name` LIKE 'thinkphp%' AND `title` LIKE '%thinkphp' AND `id` > 0 ) AND `status` = '1'

使用多个条件组合时：

$map1 = [
    ['name', 'like', 'thinkphp%'],
    ['title', 'like', '%thinkphp'],
];

$map2 = [
    ['name', 'like', 'kancloud%'],
    ['title', 'like', '%kancloud'],
];

Db::table('think_user')
    ->whereOr([ $map1, $map2 ])
    ->select();

生成的SQL语句为：

SELECT * FROM `think_user` WHERE ( `name` LIKE 'thinkphp%' AND `title` LIKE '%thinkphp' ) OR ( `name` LIKE 'kancloud%' AND `title` LIKE '%kancloud' )

善用多维数组查询，能方便地拼装出各种复杂的SQL语句。

闭包查询

$name = 'thinkphp';
$id = 10;
Db::table('think_user')->where(function ($query) use($name, $id) {
    $query->where('name', $name)
        ->whereOr('id', '>', $id);
})->select();

生成的SQL语句为：

SELECT * FROM `think_user` WHERE ( `name` = 'thinkphp' OR `id` > 10 )

每个闭包条件两边会自动加上括号。

混合查询

可以结合前面提到的所有方式进行混合查询，例如：

Db::table('think_user')
    ->where('name', 'like', 'thinkphp%')
    ->where(function ($query) {
        $query->where('id', '<', 10);
    })
    ->select();

生成的SQL语句是：

SELECT * FROM `think_user` WHERE  `name` LIKE 'thinkphp%' AND ( `id` < 10 )

字符串条件查询

对于复杂的查询，可直接使用原生SQL语句进行查询，例如：

Db::table('think_user')
    ->whereRaw('id > 0 AND name LIKE "thinkphp%"')
    ->select();

为了安全起见，可对字符串查询条件使用参数绑定，例如：

Db::table('think_user')
    ->whereRaw('id > :id AND name LIKE :name ', ['id' => 0, 'name' => 'thinkphp%'])
    ->select();

快捷方法

系统封装了一系列快捷方法，用于简化查询，具体如下：

下面举例说明whereColumn方法的用法：

// 查询update_time大于create_time的用户数据
Db::table('think_user')
    ->whereColumn('update_time', '>', 'create_time')
    ->select();

生成的SQL语句是：

SELECT * FROM `think_user` WHERE ( `update_time` > `create_time` ) 

// 查询name和nickname相同的用户数据
Db::table('think_user')
    ->whereColumn('name', '=', 'nickname')
    ->select();

生成的SQL语句是：

SELECT * FROM `think_user` WHERE ( `name` = `nickname` )

相同字段条件也可以简化为：

Db::table('think_user')
    ->whereColumn('name', 'nickname')
    ->select();

支持数组方式比较多个字段：

Db::name('user')->whereColumn([
    ['title', '=', 'name'],
    ['update_time', '>=', 'create_time'],
])->select();

生成的SQL语句是：

SELECT * FROM `think_user` WHERE ( `name` = `nickname` AND `update_time` > `create_time` ) 

动态查询

查询构造器提供了动态查询机制，用于简化查询条件，具体如下：

其中FieldName表示数据表的实际字段名称的驼峰法表示。假设数据表user中有email和nick_name字段，可这样查询：

// 根据邮箱（email）查询用户信息
$user = Db::table('user')
    ->whereEmail('thinkphp@qq.com')
    ->find();

// 根据昵称（nick_name）查询用户
$email = Db::table('user')
    ->whereNickName('like', '%流年%')
    ->select();

// 根据邮箱查询用户信息
$user = Db::table('user')
    ->getByEmail('thinkphp@qq.com');

// 根据昵称（nick_name）查询用户信息
$user = Db::table('user')
    ->field('id,name,nick_name,email')
    ->getByNickName('流年');

// 根据邮箱查询用户的昵称
$nickname = Db::table('user')
    ->getFieldByEmail('thinkphp@qq.com', 'nick_name');

// 根据昵称（nick_name）查询用户邮箱
$email = Db::table('user')
    ->getFieldByNickName('流年', 'email');

getBy和getFieldBy方法只会查询一条记录，可以和其它的链式方法搭配使用。

条件查询

查询构造器支持条件查询，例如：

Db::name('user')->when($condition, function ($query) {
    // 满足条件后执行
    $query->where('score', '>', 80)->limit(10);
})->select();

并且支持不满足条件的分支查询：

Db::name('user')->when($condition, function ($query) {
    // 满足条件后执行
    $query->where('score', '>', 80)->limit(10);
}, function ($query) {
    // 不满足条件执行
    $query->where('score', '>', 60);
});