ThinkPHP5搜索查询怎么写_ThinkPHP5多条件搜索查询方法【实战】-ThinkPHP-PHP中文网

thinkphp 5 多条件查询关键在括号层级与逻辑分组：| 分隔仅支持同运算符的多字段 or；混合 and/or 必须用闭包分组；动态条件推荐 when 避免空数组风险；in 条件需防键名覆盖与 null 值。

thinkphp5搜索查询怎么写_thinkphp5多条件搜索查询方法【实战】

ThinkPHP 5 的多条件搜索查询不是靠堆 where 就能写对的，核心在于括号层级和逻辑分组——错一层，SQL 就跑偏。

搜索字段用 | 分隔表示 OR，但只适用于相同运算符

比如想查「用户名或昵称包含关键词」，直接写：['user_login|user_nickname', 'like', "%{$keyword}%"]。TP5 会自动拆成 (`user_login` LIKE ? OR `user_nickname` LIKE ?)。

但注意：这个快捷写法只支持单个运算符（如 like、=），不能混用 like 和 in；也不能用于不同字段不同条件（比如「name like %x% OR status = 1」就不能用 | 写）。

✅ 正确：Db::name('user')->where('name|email', 'like', '%admin%')->select()
❌ 错误：Db::name('user')->where('name|status', 'like', '%admin%')（status 字段不支持 like，报错或无结果）
⚠️ 隐患：如果 $keyword 为空，like '%%' 可能全表扫描，建议加 if (!empty($keyword)) 判断

混合 AND 和 OR 必须用闭包分组，否则逻辑错乱

要实现「状态启用 AND (是 VIP OR 有优惠券)」，必须把 OR 部分包进闭包，否则 TP5 会按链式顺序平铺拼接，导致 SQL 变成 WHERE status = 1 OR is_vip = 1 OR coupon_id > 0 ——完全不是你要的。

正确写法是：

Db::name('user')
    ->where(['status' => 1])
    ->where(function ($query) {
        $query->where('is_vip', 1)
              ->whereOr('coupon_id', '>', 0);
    })
    ->select();

闭包里调用的是 $query->where()，不是静态 where()，否则作用域错误
whereOr 在闭包外全局调用会污染后续所有条件，只在闭包内安全
多个闭包嵌套时，顺序决定 SQL 括号位置：先 where($arr) 再 where($closure)，生成的是 AND ( ... )；反过来就是 ( ... ) AND

动态条件别用空数组硬塞，用 `when` 更干净

用户搜索表单常有可选字段（比如只填了城市没填年龄），很多人习惯这样写：

ThinkPHP5+layui框架后台管理系统

thinkphp5,layui后台,php后台管理,后台管理系统,thinkphp框架

下载

$where = [];
if (!empty($city)) $where['city'] = $city;
if (!empty($age_min)) $where['age'] = ['>=', $age_min];
// ……然后 Db::where($where)

问题在于：如果所有条件都为空，$where 是空数组，where([]) 会清空整个查询条件，导致查出全表数据，极危险。

推荐用 when 方法，它只在条件为真时才执行闭包内的构建逻辑：

Db::name('user')
    ->when(!empty($city), function ($query) use ($city) {
        $query->where('city', $city);
    })
    ->when(!empty($age_min), function ($query) use ($age_min) {
        $query->where('age', '>=', $age_min);
    })
    ->when(!empty($keyword), function ($query) use ($keyword) {
        $query->where('name|email', 'like', "%{$keyword}%");
    })
    ->select();

when 不依赖变量是否为空数组，而是判断布尔值，语义清晰、不易出错
避免手写一堆 if + where 拼接，代码更线性、易维护
TP5.1+ 支持，老版本需自行封装或坚持用 if 判断

多个 IN 条件别共用键名，数组结构要严格

查「用户 ID 在列表中 OR 所属部门 ID 在另一列表中」，不能写成：

// ❌ 错误示范
$where['id'] = ['in', $userIds];
$where['dept_id'] = ['in', $deptIds]; // 这样写没问题，但下面这种就崩了
$where['id'] = ['in', $userIds];
$where['id'] = ['in', $otherIds]; // 后者覆盖前者，只剩一个 IN

TP5 数组 where 中键名重复即覆盖，且 ['in', $ids] 必须是数组，不能传字符串 ['in', '1,2,3'] ——那会被当字面量字符串处理，查不到任何数据。

✅ 正确：['id' => ['in', $userIds], 'dept_id' => ['in', $deptIds]]
✅ 多字段 OR 查询（非同一字段）：必须用闭包 + whereOr，例如：$query->where('id', ['in', $a])->whereOr('dept_id', ['in', $b])
⚠️ 注意：IN 的值数组不能含 null，否则生成 SQL 会出错；建议提前 array_filter($ids, 'is_numeric')

真正容易翻车的点，往往不在语法本身，而在括号层级是否匹配你脑中的逻辑树——写完一定要用 getLastSql() 看一眼生成的 SQL，别信直觉。