thinkphp 6 的 where 数组默认严格等值匹配，空值也会生成 where 条件导致误过滤；应动态构建条件数组、模糊查询需单独调用 where('field', 'like', ...)，搜索器须显式定义并配合 withsearch 使用，且需注意执行顺序、转义与空值处理。
ThinkPHP 6 的 where 数组写法为什么搜不出数据？
不是数组格式不对，而是默认用了「严格等值匹配」——where 数组里填的键值对，会直接转成 = 条件，不支持模糊、范围或空值跳过。
- 常见错误现象：
['title' => $keyword, 'status' => $status]中，若$keyword为空字符串或null，仍会生成WHERE title = ''，把非空记录全过滤掉了 - 正确做法是动态拼数组：只把有实际值的条件加进去，比如用
array_filter($data, function($v) { return $v !== '' && $v !== null; }) - 注意
array_filter默认会重置键名，需加ARRAY_FILTER_USE_BOTH或手动保留键：用foreach显式构建 - 如果字段要模糊查（如标题含关键词），不能塞进数组，得单独调
where('title', 'like', "%{$keyword}%")
搜索器（searcher）在 TP6 里怎么定义才生效？
搜索器不是自动触发的魔法方法，它依赖模型里显式声明的 search 方法 + 查询时传入 search 参数，且字段名必须和搜索器方法名严格对应。
- 使用场景：用户输入「创建时间区间」、「状态+类型组合」、「多字段关键词」这类需要逻辑处理的搜索
- 定义方式：在模型中写 public function searchCreateTimeAttr($query, $value) { ... }，其中
createTime是搜索字段名（驼峰），Attr后缀不可少 - 调用时必须用
->where('create_time', 'between', $range)->withSearch(['createTime'], $params)，withSearch第二个参数才是传给搜索器的原始值 - 容易踩的坑：
searchCreateTimeAttr里的$query是闭包，不是 Query 对象；不能在里面调$query->where()，得用$query($builder)形式修改查询构造器
多个搜索条件混用时，where 数组和 withSearch 谁先执行？
TP6 查询构造顺序是：先跑 where 链式调用和数组，再跑 withSearch —— 所以搜索器内部不能覆盖外部已写的 where，但可以追加或修正。
- 性能影响：
withSearch每个搜索器都是独立函数调用，如果写了 5 个搜索器，就会执行 5 次闭包，建议只对真正需要逻辑判断的字段启用 - 兼容性注意：TP6.0 和 6.1+ 在
withSearch的参数透传上略有差异，6.1 支持第三个参数传入$options控制是否启用某搜索器 - 典型冲突：外部写了
->where('status', 1)，搜索器里又写了$query->where('status', 2)，最终 SQL 是AND status = 1 AND status = 2，结果永远为空 —— 这时候应该在搜索器里做条件合并，而不是硬写where
搜索条件带空格或特殊字符时怎么安全处理？
用户输「 PHP教程 」这种首尾空格，或「a%b_c」这种含通配符的关键词，不清理就直接进 like，要么查不到，要么 SQL 报错或被注入。
- 必须在进搜索逻辑前 trim：用
trim($keyword)去空格，再判断是否为空，空则跳过该条件 - like 匹配要转义：TP6 的
where('title', 'like', "%{$keyword}%")不自动转义，得手动用str_replace(['%', '_'], ['%', '_'], $keyword)，再加escape => true参数（如->where('title', 'like', "%{$escaped}%", ['escape' => '\'])） - 别信前端 JS 的 trim —— 后端必须重做，因为请求可能绕过前端直接发
- 如果用的是
withSearch，这些清洗动作要放在搜索器函数最开头，别等到拼 SQL 时才发现问题
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
