ThinkPHP6查询构造器whereOr多条件查询,逻辑踩坑-ThinkPHP-PHP中文网

tp6的whereor()默认不加括号，因and优先级高于or，易导致逻辑错误；必须用闭包显式包裹or条件，多组or需嵌套闭包，确保逻辑准确。

thinkphp6查询构造器whereor多条件查询,逻辑踩坑

whereOr不加括号，AND优先级会搞乱整个逻辑

TP6 的 whereOr() 默认不加括号，SQL 中 AND 总是比 OR 优先，所以 where('status', 1)->where('name', 'like', '%a%')->whereOr('type', 2) 生成的是 WHERE status = 1 AND name LIKE '%a%' OR type = 2，等价于 (status = 1 AND name LIKE '%a%') OR type = 2——这几乎从来不是你想要的。

常见错误现象：后台搜索时“状态=1 且（标题或类型匹配）”写成链式 whereOr，结果查出一堆 type=2 但 status≠1 的脏数据。

永远别依赖默认优先级，whereOr 出现在多个 AND 条件之后，就必须用闭包显式包住 OR 部分
哪怕只有一组 OR，也建议统一用闭包，避免后续加条件时踩坑
不要数 whereOr 调用了几次来判断括号位置——TP6 不按调用次数加括号，只看是否在同一个闭包内

多组 OR 组合必须嵌套闭包，一层不够就两层

要实现类似 (age > 20 AND sex = 2) OR (age 这种结构，不能靠 <code>whereOr($map1)->whereOr($map2)，那样会变成 WHERE map1 OR map2，丢失外层 AND 上下文。

正确做法是把每组完整条件放进独立闭包，再用 whereOr() 连接它们：

$list = User::where(function ($query) {
    $query->where('age', '>', 20)->where('sex', 2);
})->whereOr(function ($query) {
    $query->where('age', 'where('sex', 1);
})->select();

每个闭包 = 一对圆括号，这是 TP6 唯一能精确控制 SQL 分组的方式
如果还有外部 AND 条件（比如 status = 1），必须放在最外层 where()，不能塞进某个闭包里
嵌套三层及以上极少必要，多数是设计问题；真有复杂场景，先拆 SQL 再反推闭包结构

数组形式的 where + | 或 & 操作符，仅限简单字段同操作符

TP6 支持 where('name|title', 'like', '%x%') 表示 name LIKE '%x%' OR title LIKE '%x%'，但它只适用于「同一操作符+多个字段」的扁平场景。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

一旦涉及不同操作符（比如 name like 和 id in）、或需要混合 AND/OR 层级，数组语法立刻失效。例如下面写法不会按预期工作：

// ❌ 错误：'name|type' 只能配一个操作符，无法表达 name like OR type = 2
where('name|type', ['like' => '%x%', '=' => 2])

// ✅ 正确：回到闭包
where(function ($query) {
    $query->where('name', 'like', '%x%')->whereOr('type', 2);
})

| 是字段 OR，& 是字段 AND，都只作用于左侧字段列表，右侧必须是单值或统一操作符
不要试图用 ['name|type' => ['like', '%x%']] 混用操作符——TP6 解析不了，静默忽略或报错
这种语法适合搜索框「关键词匹配多个字段」，不适合业务规则类复杂查询

动态拼 OR 条件时，空值过滤必须在闭包外完成

用 when() 或手动 if 判断拼条件时，OR 部分如果含空值，会导致整个闭包条件被跳过，而不是跳过某一条子条件。

例如用户没填搜索词，但写了：

$query->where('status', 1)
      ->where(function ($q) use ($keyword) {
          $q->where('title', 'like', "%{$keyword}%")
            ->whereOr('content', 'like', "%{$keyword}%");
      });

当 $keyword 为空时，where('title', 'like', '%%') 仍会生效，可能查出全部数据。