ThinkPHP搜索功能需用array_filter过滤空值、|实现多字段OR模糊查询、搜索器处理复杂条件；空值不清理会导致全表过滤，字段名丢失因未用ARRAY_FILTER_USE_BOTH，零值保留须用strlen判断，关键词需addcslashes转义，搜索器必须按searchFieldNameAttr命名且withSearch静态调用。
ThinkPHP 的搜索功能不是填个 where 数组就能跑通的，空值、模糊、多字段 OR、时间范围这些常见需求，直接硬写会漏数据或报错。
空值导致全表过滤怎么办
TP6 的 where 数组默认做严格等值匹配，['title' => '', 'status' => null] 会生成 WHERE title = '' AND status = NULL，结果一条不剩。
- 用
array_filter($data, function($v) { return $v !== '' && $v !== null && $v !== [] && $v !== false; }, ARRAY_FILTER_USE_BOTH)过滤无效值 - 别省略
ARRAY_FILTER_USE_BOTH，否则字段名丢了，条件就失效 - 如果要保留零值（比如
score = 0），改用strlen((string)$v) === 0判断空字符串更稳妥 - 动态构建条件数组比依赖
where数组更可控，尤其在表单提交场景下
多字段模糊查为什么用 | 不用数组
写成 ['title' => "%{$k}%", 'content' => "%{$k}%"] 是 AND 关系，逻辑不对；而 ['title|content|username' => ['like', "%{$k}%"]] 才是 OR。
-
|表示字段间 OR，&表示 AND，字段名之间不能有空格 - 字段类型不一致（如
content是 TEXT，title是 VARCHAR）可能导致 MySQL 隐式转码失败，建议模型里加->bind(['title' => PDO::PARAM_STR]) - 关键词含
%、_等 SQL 特殊字符，必须先addcslashes($keyword, '%_\')转义再拼"%{$escaped}%"
复杂条件必须用搜索器，但 withSearch 不是万能胶
withSearch 是唯一触发搜索器的方法，但它只在模型类上静态调用才有效，User::withSearch(['createTime'], $params)->select() ✅，User::where()->withSearch() ❌ 直接报错。
立即学习“PHP免费学习笔记（深入）”；
- 搜索器方法名必须是
searchFieldNameAttr格式，比如字段是create_time→ 方法名是searchCreateTimeAttr -
searchCreateTimeAttr的第一个参数$query是闭包，不是 Query 对象，得写成$query(function ($builder) use ($value) { $builder->whereBetween('create_time', $value); }); - 外部写的
where('status', 1)和搜索器里的where('status', 2)会同时生效，变成AND status = 1 AND status = 2→ 结果为空，得在搜索器里手动unset外部冲突条件 - TP6.1+ 支持第三个参数控制开关：
withSearch(['createTime'], $params, ['createTime' => false])，TP6.0 不支持
Elasticsearch 集成不是装个包就完事
ThinkPHP 本身不带 ES 支持，Class 'ElasticsearchClientBuilder' not found 是环境问题，不是框架 bug。
- 运行
composer require elasticsearch/elasticsearch:^8.0（ES 8.x 服务端必须配 8.x 客户端） - 确认
ext-curl已启用：php -m | grep curl，没输出就打开php.ini的extension=curl - ES 默认禁用自动建索引，必须显式调
$client->indices()->create()，并在mappings中为中文字段指定'analyzer' => 'ik_smart' - 数据同步靠钩子：在模型
afterWrite里调bulk写入（100 条/批），在afterDelete里补delete，否则删了 MySQL 记录，ES 还留着
搜索器命名规则、withSearch 的调用位置、ES 索引创建时机——这三个点最容易被跳过，一漏就卡半天。
