ThinkPHP搜索功能开发教程-ThinkPHP-PHP中文网

thinkphp搜索功能需用array_filter过滤空值、|实现多字段or模糊查询、搜索器处理复杂条件；空值不清理会导致全表过滤，字段名丢失因未用array_filter_use_both，零值保留须用strlen判断，关键词需addcslashes转义，搜索器必须按searchfieldnameattr命名且withsearch静态调用。

thinkphp搜索功能开发教程

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。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

| 表示字段间 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() ❌ 直接报错。

搜索器方法名必须是 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 还留着