直接结论：用 whereLike 和 where 手动拼条件，别依赖自动转换；核心是把搜索类型（like 或 =）从用户输入或配置里提出来，再决定调哪个方法。
ThinkPHP 模型查询时字段搜索模式怎么动态切模糊/精确？
直接结论：用 whereLike 和 where 手动拼条件，别依赖自动转换；核心是把搜索类型（like 或 =）从用户输入或配置里提出来，再决定调哪个方法。
ThinkPHP 的模型查询本身不提供“字段级搜索模式开关”，所谓“一键切换”其实是自己控制条件构造逻辑。框架的 where 方法默认走精确匹配，whereLike 固定加 %，两者底层生成的 SQL 完全不同——混用或硬套会导致 SQL 错误或查不到数据。
- 用户提交
search_type=like且字段为title→ 用whereLike('title', $value) - 用户提交
search_type=exact→ 用where('title', $value) - 字段名和搜索类型必须成对传入，不能全局设“所有字段都模糊”，否则邮箱、ID 类字段会出问题
为什么不能用 where('field', 'like', '%val%') 模拟动态切换？
这个写法看似灵活，但实际踩坑率极高：ThinkPHP 6+ 中 where('field', 'like', '%val%') 会被当成字符串值处理，不是操作符，最终生成的 SQL 是 WHERE field = 'like' AND '%val%'，直接报错或恒假。
正确做法是用闭包或显式调用带操作符的方法：
立即学习“PHP免费学习笔记（深入）”；
$query->where(function ($q) use ($field, $value, $mode) {
if ($mode === 'like') {
$q->whereLike($field, "%{$value}%");
} else {
$q->where($field, $value);
}
});
- 注意
whereLike不会自动加左右%，得手动拼，不然只是右模糊 - 如果用户输入含
%或_，要先addcslashes($value, '%_')防止通配符注入 - MySQL 严格模式下，空字符串用
like ''可能不走索引，精确匹配更安全
多个字段混合搜索时，怎么让每个字段独立控制模糊/精确？
常见场景：用户想对 username 精确搜、对 remark 模糊搜。这时候不能共用一个 $mode 变量，得按字段配策略。
推荐用映射数组定义字段行为，避免硬编码分支：
$searchMap = [
'username' => 'exact',
'remark' => 'like',
'status' => 'exact',
];
foreach ($searchMap as $field => $mode) {
$value = $this->request->param($field);
if ($value !== null && $value !== '') {
if ($mode === 'like') {
$query->whereLike($field, "%{$value}%");
} else {
$query->where($field, $value);
}
}
}
- 字段名必须白名单校验，防止用户传
id[like]这类非法键名绕过控制 - 如果前端用同一参数名（如
search[username]=xxx&search[remark]=yyy），后端要用$this->request->param('search/a')获取关联数组 - 日期、数字字段强行模糊搜索没意义，这类字段在
$searchMap里只能设exact，否则可能触发类型转换异常
用 scope 封装搜索逻辑后，为什么测试时总是漏掉空值判断？
封装成模型作用域（scopeSearch）看着干净，但最容易忽略的是：用户没填某个字段时，$value 可能是空字符串、null 或未定义，直接进 whereLike 会导致 WHERE field LIKE '%%'，查出全表。
必须在作用域里做三层过滤：存在性 → 非空 → 非纯空白：
- 用
isset($params[$field])判断参数是否存在，不用array_key_exists（后者会把null当有效） - 用
is_string($value) && trim($value) !== ''过滤空白值，empty()会把0、'0'也干掉，不适合数字字段 - 如果字段允许搜索
NULL值（如备注为空），需额外约定特殊标记（如_null），不能靠空字符串推断
动态搜索真正的复杂点不在语法，而在字段语义和用户输入意图的对齐——同一个输入框，对用户名是精确优先，对日志内容就得模糊优先，这个边界得在业务层划清楚，框架只负责执行。
