whereor 不等于简单追加 or 条件，因 sql 中 and 优先级高于 or，需用闭包显式分组，否则逻辑错误；如查“已启用且（姓名含张或类型为vip）”，须用 where 内嵌 whereor 闭包。
whereOr 不等于“加一个 OR 条件”
很多人直觉认为 whereOr('field', 1) 就是在已有条件后“追加一个 OR 分支”，但实际不是。ThinkPHP 的查询构造器按链式顺序拼接 SQL，不自动加括号，而 SQL 中 AND 优先级高于 OR。这意味着：
-
->where('a', 1)->where('b', 2)->whereOr('c', 3)生成的是WHERE a=1 AND b=2 OR c=3 - 等价于
(a=1 AND b=2) OR c=3，而非开发者常想要的a=1 AND (b=2 OR c=3)
一旦逻辑意图是“主过滤 +（多选一）”，这种写法就会漏数据或查出无关记录。
典型翻车场景：混合筛选+状态 OR 类型
比如查“已启用且（姓名含张 或 类型为 VIP）”：
- 错误写法：
$user->where('status', 1)->where('name', 'like', '%张%')->whereOr('type', 'vip')->select();
→ 实际 SQL：WHERE status=1 AND name LIKE '%张%' OR type='vip'
结果可能包含所有 type='vip' 的用户，哪怕 status≠1 - 正确写法必须显式分组：
$user->where('status', 1)->where(function ($q) {<br> $q->where('name', 'like', '%张%')->whereOr('type', 'vip');<br>})->select();
→ 生成：WHERE status=1 AND (name LIKE '%张%' OR type='vip')
嵌套 OR：两组 AND 条件之间用 OR 连接
当需求是 “(年龄>20 且 性别=女) OR (年龄
- 错误：
->whereOr($group1)->whereOr($group2)→ 全部变成 OR，失去内部 AND 关系 - 正确：每组 AND 条件各自独立闭包，再用
whereOr连接两个闭包：$user->where(function ($q) { $q->where('age', '>', 20)->where('sex', 2); })<br> ->whereOr(function ($q) { $q->where('age', 'where('sex', 1); })<br> ->select();
这会精准生成：WHERE (age > 20 AND sex = 2) OR (age
动态条件中 or 组合易被忽略的细节
带搜索参数的列表页，常需支持“标题或内容匹配关键词”，同时叠加其它固定条件（如状态、时间范围）。此时要注意：
- 不能把
title|content数组写法和whereOr混用，容易触发隐式逻辑冲突 - 推荐统一用闭包封装 OR 部分：
if (!empty($params['keyword'])) {<br> $query->where(function ($q) use ($params) {<br> $q->where('title', 'like', "%{$params['keyword']}%")<br> ->whereOr('content', 'like', "%{$params['keyword']}%");<br> });<br>} - 空值判断要严谨：用
isset() && strlen()判字符串，避免'0'被当成空跳过
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
