ThinkPHP8.1伪静态try_files里△args为什么能保留分页参数-ThinkPHP-PHP中文网

$args能保留分页参数，是因为它原样透传Nginx接收到的原始查询字符串，ThinkPHP 8.1路由解析默认启用QUERY_STRING模式，自动从$_SERVER['QUERY_STRING']提取s=参数及page、keyword等业务参数并合并入Request::param()供paginate()直接使用。

thinkphp8.1伪静态try_files里△args为什么能保留分页参数

$args 能保留分页参数，是因为它直接代表 Nginx 接收到的原始查询字符串（query string），未经修改、未解码、未截断，原样透传给 index.php。

ThinkPHP 8.1 的路由解析默认启用 QUERY_STRING 模式（即 url_route_on = true 且未强制设为 pathinfo 模式），它会从 $_SERVER['QUERY_STRING'] 中提取 s= 参数（或自动识别标准分页参数如 page=2&limit=10）来匹配路由和构造分页上下文。

当你在 try_files 中写成：

try_files $uri $uri/ /index.php?$query_string;

或旧式但依然有效的写法：

try_files $uri $uri/ /index.php?s=$uri&$args;

其中 $args 就是请求 URL 中 ? 后面的全部内容，例如：

PHP 8.5.12

修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。

下载

请求 /user/list?page=3&limit=20&keyword=测试
→ $args 的值就是 page=3&limit=20&keyword=测试
→ 最终转发为 /index.php?s=/user/list&page=3&limit=20&keyword=测试

ThinkPHP 8.1 的 Route 组件会自动识别并合并这些参数：

s=/user/list 告诉框架要访问的路由地址
page、limit、keyword 等则被收集进 Request::param()，分页方法（如 paginate()）可直接读取它们

所以关键点在于：

$args 不是“拼出来的”，而是 Nginx 内置变量，实时映射客户端原始查询串
TP8.1 不依赖 PATH_INFO 解析分页参数，而是信任 $_GET 和 $_SERVER['QUERY_STRING']
即使中文参数（如 keyword=文章）经过 UTF-8 编码传输，PHP 接收后也会自动解码为 $_GET['keyword'] === '文章'，前提是 Nginx 未做二次解码干扰

常见错误导致分页参数丢失的情况包括：

错误使用 if (!-e $request_filename) { rewrite ... }：该逻辑可能丢弃 $args 或重写时未显式携带
try_files 写成 /index.php?s=$uri（漏掉 &$args）：所有 ?page=... 都被丢弃
在 location ~ \.php$ 块中缺失 fastcgi_param QUERY_STRING $query_string;：虽然 Nginx 默认传递，但显式声明更稳妥，尤其在自定义 fastcgi_params 场景下
使用了 fastcgi_split_path_info 并正则不匹配：可能污染 PATH_INFO，干扰框架对 s= 的提取逻辑（TP8.1 已弱化依赖，但仍建议禁用以防冲突）