TP6的whereOr()默认不加括号，因AND优先级高于OR，易导致逻辑错误；必须用闭包显式包裹OR条件，多组OR需嵌套闭包，确保逻辑准确。
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() 连接它们：
立即学习“PHP免费学习笔记（深入）”；
$list = User::where(function ($query) {
$query->where('age', '>', 20)->where('sex', 2);
})->whereOr(function ($query) {
$query->where('age', '<', 20)->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%'，但它只适用于「同一操作符+多个字段」的扁平场景。
一旦涉及不同操作符（比如 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', '%%') 仍会生效，可能查出全部数据。
- OR 条件里的每个子项都要单独判空，不能只判闭包入口变量
- 更稳妥的做法是：先收集所有待 OR 的条件数组，过滤空值后，再传给
whereOr($array)（TP6.3+ 支持）或用循环 + 闭包动态构建 - 时间范围类条件（如
between time）尤其危险，start_time或end_time任一为空，between就会失效甚至报错
