闭包查询是控制SQL括号层级的唯一可靠手段，必须用use传参，whereOr须挂载在主where之后，多层嵌套需结构化设计或退至whereRaw。
闭包查询不是语法糖，是控制 SQL 括号层级的唯一可靠手段；不写闭包，复杂 OR/AND 混合条件大概率生成错的 SQL。
闭包里必须用 use 传参，否则变量不可见
ThinkPHP 的闭包运行在独立作用域，外部变量默认进不去。比如搜索关键词 $keyword，直接在闭包里用会报未定义变量错误。
- 错误写法：
$query->where('title', 'like', "%$keyword%")——$keyword不在闭包作用域 - 正确写法：
function ($query) use ($keyword) { $query->where('title', 'like', "%$keyword%"); } - 多个变量就写全：
use ($keyword, $status, $start_time) - 注意：TP 6.3+ 若
use的变量名和字段名重名（如都叫$status），可能触发绑定混淆，建议加前缀，如$input_status
whereOr 必须挂载在有主 where 的链路上，否则 SQL 以 OR 开头报错
TP 不允许 WHERE 子句以 OR 起始，所以 whereOr 不能单独调用，也不能放在最前面。
- 错误示例：
Db::table('user')->whereOr(['name', 'like', 'a'])->select()→ 报错或结果异常 - 正确结构：至少有一个前置
where，再接whereOr或闭包版whereOr - 推荐写法：
->where(['is_delete' => 0])->whereOr(function ($q) { $q->where('name', 'like', 'x')->where('email', 'like', 'x'); }) - 如果真要“纯 OR”逻辑（比如多组 AND 组合之间全用 OR 连接），老实用
whereRaw或先构造子条件数组再传给whereOr
嵌套三层以上闭包时，括号不会自动叠加，得靠结构设计保逻辑
每个闭包只生成一层括号，TP 不递归包裹。三层闭包不是 ((a AND b) OR (c AND d)) AND e，而是 (a AND b) OR (c AND d) AND e —— 括号只出现在每个闭包内部，连接符由外层方法决定。
立即学习“PHP免费学习笔记（深入）”；
- 常见陷阱：在闭包里又调
whereOr，但外层没主where带着，导致括号缺失或 SQL 语法错误 - 两层以内优先用闭包 +
whereOr，清晰且安全 - 超过两层，建议拆成变量：
$sub1 = [['a', '=', 1], ['b', '>', 10]]; $sub2 = [['c', '=', 2], ['d', 'like', '%x%']]; Db::where([$sub1])->whereOr([$sub2])->select(); - 极端复杂场景（如带子查询、函数计算）直接上
whereRaw，可控性远高于堆闭包
真正难的不是写对闭包语法，而是把业务逻辑准确映射成括号分组——先画出括号树，再决定哪里该切闭包、哪里该用 whereOr、哪里该退回到 whereRaw。漏掉一个括号层级，SQL 就可能跑偏。
