ThinkPHP分页appends()无法追加复杂参数是因为其仅支持扁平键值对，嵌套数组（如filter[status]）会被URL编码导致后端无法识别；应使用TP6+的withQuery()或手动flatten_params处理后再传入。
ThinkPHP 分页 appends() 为什么追加不了复杂参数
因为 appends() 默认只接受扁平键值对，遇到嵌套数组（比如 filter[status]、sort[by]=name&sort[dir]=desc）会直接丢弃或被 URL 编码后解析失败。框架底层用 http_build_query() 拼接，但没做深层键名还原。
常见错误现象：$_GET 里有 filter[category]=12，但分页链接里变成 ?page=2&filter=[category]=12，后端收不到 filter['category']。
- 使用场景：带多条件筛选、排序、范围查询的后台列表页
- 参数差异：
appends($array)传入原始$_GET数组会出错；必须先 flatten 再过滤空值 - 性能影响极小，只是字符串处理；兼容性上 PHP 7.4+ 和 TP6/TP8 均适用
手动 flatten 并安全传给 appends()
不能直接 $list->appends($_GET)，要先把嵌套键展开成点号或中括号格式，并跳过分页相关键（如 page）。
实操建议：写个简单辅助函数，例如：
立即学习“PHP免费学习笔记（深入）”；
function flatten_params($params, $prefix = '') {
$result = [];
foreach ($params as $key => $value) {
$new_key = $prefix ? $prefix . '[' . $key . ']' : $key;
if (is_array($value)) {
$result += flatten_params($value, $new_key);
} else {
$result[$new_key] = $value;
}
}
return $result;
}
然后在模板或控制器里这样用：
$list->appends(flatten_params(array_diff_key($_GET, ['page'])))- 注意排除
page，否则会重复出现page=1&page=2 - 如果用了伪静态路由，确保
appends()生成的是 query string，不是 path segment
TP6+ 的 withQuery() 更适合复杂场景
appends() 是老方案，TP6 新增的 withQuery() 支持原样保留整个查询结构，包括方括号和点号，且自动过滤分页参数。
它本质是把参数存进 Paginator 实例的 query 属性，渲染时走更可控的拼接逻辑。
- 用法：
$list->withQuery($_GET)，无需 flatten - 注意：必须在调用
render()前设置，且不能和appends()混用 - 兼容性：仅 TP6.0.12+ 和 TP8，低版本无效
- 如果你项目已升级 TP6+，优先用
withQuery()，省去手动 flatten 的风险
URL 编码与后端接收不一致的坑
即使参数 append 成功，也可能因编码方式不同导致后端收不到——比如前端传 filter[status]=1（即 filter[status]=1），但框架解析时没还原方括号语义。
关键点：
- 确认你用的是
input('filter.status')还是input('filter')：前者依赖 Request 类自动展开，后者拿到的是原始数组 - TP6 默认开启
param_convert，但若关闭了或用了自定义 Request 类，input('filter.status')就会返回 null - 最稳做法：分页前用
input('', '', false)获取原始未 decode 的$_GET，再传给withQuery()
复杂点不在分页本身，而在“参数从哪来、怎么传、后端怎么认”这三步是否闭环。漏掉任意一环，appends 或 withQuery 都只是徒劳。
