thinkphp动态查询可自动忽略空值实现多条件筛选，需先配置模型字段映射；支持链式调用如wherename→wherestatus，也支持组合模糊与范围查询混用标准where语法。
刚接触ThinkPHP的新手常被多条件筛选卡住——表单提交一堆字段，控制器里写一堆if判断拼where，稍不注意就漏条件或SQL报错。其实框架早内置了动态查询机制，不用手动拼数组也能安全过滤空值、自动跳过未填写项。
理解动态查询的本质
ThinkPHP的动态查询不是魔法，它本质是把方法名里的字段名自动转成数据库字段，再把参数当值处理。比如User::getByName('admin')等价于where('name', 'admin')->find()，但前提是模型里必须存在name字段映射，否则直接报错。
这一步不能跳过：打开你的User模型类，确认protected $schema = ['id', 'name', 'email', 'status'];或已开启auto_schema，否则动态方法找不到对应字段。
用动态方法实现基础多条件筛选
用户在前端填了「姓名」和「状态」两个搜索框，后端只需两行代码：
方法一：链式调用多个动态方法$list = User::whereName($name)->whereStatus($status)->select();
注意：只要传入的变量为null或空字符串，该条件会自动被忽略——这是ThinkPHP 6.1+的默认行为，无需额外判空。
方法二：一次性调用带前缀的复合方法$list = User::getByNameAndStatus($name, $status);
这个方法名必须严格匹配字段顺序，且只返回单条记录；若要查列表，得改用allByNameAndStatus，但该方法在TP6中已被废弃，切勿使用。
组合模糊查询与范围筛选
当需要同时支持「用户名包含关键词」+「注册时间在某区间」时，动态方法不够用，必须混用标准where语法：
第一步：接收并清洗参数
$keyword = trim($this->request->param('keyword', ''));<br>
$start = $this->request->param('start_time', '');<br>
$end = $this->request->param('end_time', '');
第二步：初始化查询对象$query = User::query();
第三步：按需追加条件
if ($keyword) { $query->where('name', 'like', "%{$keyword}%"); }<br>
if ($start) { $query->whereTime('create_time', '>=', $start); }<br>
if ($end) { $query->whereTime('create_time', '
<p>第四步：执行查询<br><code>$list = $query->select();</code><br><strong>【关键点】</strong>这里必须用<code>whereTime</code>而非<code>where</code>处理日期，否则MySQL会因类型不匹配返回空结果，且无任何错误提示。</p>
<h2>处理前端传来的多选字段（如城市、标签）</h2>
<p>当表单中城市是<code><select multiple name="cities[]"></select></code>时，PHP收到的是数组，但直接传给<code>whereCity</code>会失败——动态方法只接受单值。</p>
<p>正确做法是放弃动态方法，改用显式<code>in</code>条件：</p>
<p></p><pre class="brush:php;toolbar:false;">$cities = $this->request->param('cities/a', []); // /a 表示强制转为数组<br>
if (!empty($cities)) {<br>
$query->where('city', 'in', $cities);<br>
}
注意：$this->request->param('cities')不加/a后缀时，若用户只选一个城市，返回的是字符串而非数组，in条件会生成IN ('shanghai')这种合法但无意义的SQL，查不到数据。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
