CakePHP 的 orWhere() 不自动加括号，导致 AND 优先级被破坏；正确做法是用 where() 包裹闭包，调用 $exp->or() 或 $exp->and() 显式分组条件。
CakePHP 的 orWhere() 不会自动加括号，直接链式调用会导致 AND 优先级被破坏，结果集常比预期大得多——这不是 Bug，是 SQL 运算符优先级的必然表现。
为什么 orWhere() 一加就错？看生成的 SQL 就明白
CakePHP 查询构造器默认把所有条件扁平拼接，where() 和 orWhere() 都只是追加子句，不隐式分组。比如：
$query = $this->Articles->find()
->where(['status' => 'published'])
->where(['category_id' => 5])
->orWhere(['author_id' => 123])
->orWhere(['featured' => true]);
生成的 SQL 实际是：
WHERE status = 'published' AND category_id = 5 OR author_id = 123 OR featured = 1
等价于：(status = 'published' AND category_id = 5) OR author_id = 123 OR featured = 1——只要作者是 123 或文章置顶，哪怕 status 不是 published 也会被查出来。
立即学习“PHP免费学习笔记（深入）”；
正确写法：必须用闭包包裹 orWhere 条件组
想表达「已发布且分类为 5，同时作者是 123 或置顶」，就得把 or 条件收进括号里。CakePHP 要求显式用 where() 接闭包：
- 错误写法：
->where(['status' => 'published'])->where(['category_id' => 5])->orWhere(...) - 正确写法：
->where(['status' => 'published'])->where(['category_id' => 5])->where(function ($exp) { return $exp->or(['author_id' => 123, 'featured' => true]); }) - 更清晰的拆分写法（推荐）：
->where(function ($exp) { return $exp->and(['status' => 'published', 'category_id' => 5]) ->or(['author_id' => 123, 'featured' => true]); })
注意：or() 是闭包内 QueryExpression 的方法，不是查询对象的链式方法；不能在闭包外直接调用 orWhere()。
复杂 or 组合：嵌套闭包 + and()/or() 混用
当 or 条件本身含 and 子条件（比如「邮箱以 @gmail.com 结尾 或 用户名包含 admin 且状态为 active」），必须分层闭包：
$query = $this->Users->find()
->where(function ($exp) {
return $exp->or([
'email LIKE' => '%@gmail.com',
'AND' => [
'username LIKE' => '%admin%',
'status' => 'active'
]
]);
});
生成的 SQL 会带完整括号：WHERE (email LIKE '%@gmail.com' OR (username LIKE '%admin%' AND status = 'active'))。
容易漏掉的点：
-
AND和OR键必须大写，且作为数组键使用 - 闭包返回值必须是
QueryExpression（即调用$exp->or()或$exp->and()） - 不要混用
orWhere()和闭包内or()，否则逻辑层级错乱
最常被忽略的是：即使只用一个 orWhere()，只要前面有多个 where()，就必须考虑括号——因为 SQL 里没有“上一个 where”的概念，只有运算符优先级。调试时直接打 $query->sql() 看生成语句，比猜逻辑可靠十倍。
