ThinkPHP 6 分页搜索条件保留与页面回显实现

周末不加班

发布时间：2026-08-25| 135人浏览过

原创

前言

列表页一做搜索，最怕的就是翻到下一页后关键词、状态和时间条件全都消失。ThinkPHP 6 里，这类问题通常不是单点故障，而是分页参数透传、模板回显和判空方式没有配齐。下面按控制器、模板和前端组件三个层面梳理，帮助你快速判断该改哪一处，才能把分页搜索真正做稳。

做列表检索时，最常见的抱怨就是“第一页搜得到，点到第 2 页条件就没了”。在 ThinkPHP 6 里，这类问题通常集中在分页器参数透传、模板字段回填，以及对 0 值的错误判断上。下面按几个最容易出错的环节拆开说明，方便你快速判断问题到底出在控制器、模板，还是前端自定义分页逻辑。

分页后搜索条件为什么会丢失

ThinkPHP 6 的分页链接默认不会替你保留当前 GET 参数。也就是说，搜索时你可能带着 keyword 访问了列表页，但点击下一页后，如果分页器没有拿到这些参数，就只会生成纯粹的页码链接，搜索条件自然丢失。

用卡片和箭头说明 ThinkPHP 6 分页如何持续携带搜索参数 — **分页参数是怎么一路带到下一页的**突出 query 透传、参数命名一致和分页链接生成之间的关系。

解决思路很明确：在调用 paginate() 时，把当前请求中的查询参数完整传给分页配置里的 query。这样分页对象在生成页码链接时，才能继续带上原来的检索条件。

示例代码如下：

$where = [];
if ($keyword = $this->request->param('keyword')) {
$where['title'] = ['like', "%{$keyword}%"];
}
$list = ArticleModel::where($where)
->order('id desc')
->paginate(10, false, [
'query' => $this->request->param() // ? 关键：把整个 GET 参数数组传进去
]);
$this->assign('list', $list);
$this->assign('keyword', $keyword);

这里有两个关键点不能漏：

1. `query` 必须传数组

query 配置项的作用，就是告诉分页器当前请求上下文里有哪些参数需要继续透传。如果这里传错类型，或者只传了部分字段，分页链接就可能缺少对应参数。

2. 参数名要和表单字段保持一致

比如搜索框字段名是 keyword，那请求参数里也必须是 keyword。否则即使你传了查询数组，生成的分页 URL 也不会正确拼出类似 ?keyword=xxx&page=2 的结果。

用便签卡片对比多条件搜索回显里 0 值被吞与正确写法 — **多条件回显里最容易漏掉的三个点**适合说明状态 0、日期范围和模板 assign 这几类回显问题。

从排查角度看，如果你已经在控制器里完成条件组装，但翻页后条件仍然消失，先检查的就该是 paginate() 的 query 配置，而不是先怀疑模板。

模板分页不带参数时该检查什么

很多人看到模板里用了 render()，就以为分页 HTML 会自动继承当前所有搜索条件。实际上，render() 只是把分页器生成好的页码结构输出出来，它能不能带参数，取决于分页器在后端生成链接时是否已经拿到了完整参数。

因此，模板层的重点不在于“换一个标签”，而在于确认 URL 构造方式和分页配置是否一致。

原生 URL 模式下的处理

如果项目使用的是原生 URL 模式，例如 index.php?s=/article/index，那么只要前面在 paginate() 里正确传入了 query 参数，模板中正常使用 render() 一般就够了。

启用路由后的注意点

如果项目启用了路由，例如通过 route('article/index') 访问页面，就要特别留意分页底层生成链接时的规则。有些场景下，你可能需要明确使用 url() 来构造目标地址。

例如：

{:url('index', array_merge(input('get.'), ['page' => 1]))}

这段写法的意义，是把当前 GET 参数和新的页码合并，再生成带条件的跳转链接。

不过从维护成本看，更推荐把参数注入逻辑统一留在控制器里处理，也就是把 input('get.') 或 $this->request->param() 放进分页配置。这样模板依旧只负责输出 render()，不会把路由拼接逻辑散落到页面里，后续也更容易排查问题。

多条件搜索回显失败，常见坑在 0 值判断

列表筛选一旦不止一个字段，问题就会明显增多。最常见的情况，是状态值存在 0 或字符串 '0'，例如“未审核”对应 0。这时如果你写成 if ($status = input('status'))，因为 0 会被当成假值，条件就直接被跳过了。

结果不仅查询条件没有生效，分页链接里也不会继续带上 status=0，模板回显自然也跟着失效。

不要用会吞掉 0 的判空方式

更稳妥的写法，是显式判断是否为空字符串，或者先判断参数是否存在，例如：

使用 input('status', '') !== ''
或使用 has('status')

这样即便状态值是 0，依然能被正确识别为有效筛选条件。

示例：

$status = $this->request->param('status', '');
if ($status !== '') {
$where['status'] = $status;
}
$this->assign('status', $status); // ? 模板 select 的 value 就靠它