本文详解如何在 nginx 配置中正确为 `/admin/users.php` 这一具体 uri 自动添加固定查询参数（如 `?sort_by=id&dir=asc&lim=2&flt=1`，避免因 location 优先级、rewrite 执行顺序或 break 标志导致的失效问题。
在 Nginx 中为特定 PHP 路径追加查询参数看似简单，但极易因配置逻辑冲突而失败。根本原因在于：Nginx 的 location 匹配优先级、rewrite 执行顺序以及 break/last 标志的行为共同决定了最终是否生效。
你当前配置中的核心问题有三：
- location 优先级冲突：你使用了 location ~ [^/]\.php(/|$)（正则匹配），它优先级高于普通前缀 location（如 location /admin/users.php），因此外部定义的独立 location 块根本不会被触发；
- rewrite 执行短路：两个 rewrite ... break 指令按顺序执行，第一个 rewrite ^/admin/?(.*) /$1 break; 会将 /admin/users.php 改写为 /users.php 并立即终止当前 rewrite 阶段，导致后续针对 /admin/users.php 的 rewrite 完全不执行；
- 目标 URI 不一致：第二次 rewrite 仍匹配原始路径 /admin/users.php，但此时请求 URI 已被第一次 rewrite 修改，无法命中。
✅ 正确做法是：将参数追加逻辑整合进 PHP 处理块内，并确保匹配的是重写后的目标路径（或直接匹配原始路径但置于更早位置）。
推荐采用以下健壮方案（适配你的完整 default.conf）：
立即学习“PHP免费学习笔记（深入）”；
location ~ \.php$ {
# ✅ 关键：先精确匹配并重写 /admin/users.php → /users.php?...（含参数）
rewrite ^/admin/users.php$ /users.php?sort_by=id&dir=ASC&lim=2&flt=1 break;
# ✅ 再处理其他 /admin/xxx.php 路径（通用去 admin 前缀）
rewrite ^/admin/?(.*)$ /$1 break;
fastcgi_split_path_info ^(.+?\.php)(/.*)$;
fastcgi_param HTTP_PROXY "";
fastcgi_pass 127.0.0.1:9000;
fastcgi_index index.php;
include fastcgi_params; # 注意：推荐用 fastcgi_params 而非 fastcgi.conf（更标准）
}? 关键说明：
- rewrite ^/admin/users.php$ ... break; 必须放在通用重写规则之前，利用 break 提前退出，确保参数被注入；
- 正则末尾的 $ 是必须的，防止误匹配 /admin/users.php?existing=param 等带参请求（若需保留原有参数，应改用 ? 或 & 拼接，见下文扩展）；
- 使用 fastcgi_params 替代 fastcgi.conf 更符合最佳实践（后者可能包含冗余或冲突变量）。
? 进阶需求：保留原始查询参数？
若需在追加参数的同时保留用户原有的查询字符串（例如访问 /admin/users.php?search=test → 变为 /users.php?search=test&sort_by=id&...），请改用：
rewrite ^/admin/users.php$ /users.php?sort_by=id&dir=ASC&lim=2&flt=1&$args break;
其中 $args 是 Nginx 内置变量，代表原始 query string（不含 ?），自动实现参数合并。
⚠️ 重要提醒：
- 切勿在同一个 location 中对同一请求多次使用 break 的 rewrite，否则后续指令不可达；
- 修改后务必执行 nginx -t 测试配置语法，并 nginx -s reload 生效；
- 若应用本身依赖 REQUEST_URI 或 $_SERVER['QUERY_STRING']，该方案完全透明，PHP 层无需任何改动。
通过精准控制 rewrite 顺序与 location 上下文，即可稳定、高效地实现指定 URI 的查询参数自动注入。
