fastcgi_param 是 Nginx 向 FastCGI 后端（如 PHP-FPM）传递请求上下文的键值映射规则，定义 Nginx 变量到 FastCGI 环境变量的转换关系，必须在 location 块中配合 fastcgi_pass 使用才能生效，且遵循“后定义覆盖前定义”的作用域覆盖原则。
在 Nginx 中，server 块通过 fastcgi_param 向 PHP-FPM（或其他 FastCGI 应用）传递参数，本质是构建一组键值对，作为 FastCGI 协议的环境变量发送。关键在于：参数必须在 location 块中定义（或被继承），且需配合 fastcgi_pass 使用，否则不会生效。
fastcgi_param 的作用域和继承规则
fastcgi_param 指令只能出现在 http、server 或 location 上下文中。它不支持“追加”，而是覆盖——同一作用域内后定义的同名参数会覆盖前面的；不同作用域间遵循继承+覆盖原则：location 中定义的参数会覆盖 server 或 http 中同名的设置。
- 全局默认参数通常写在
http块里（如常见的fastcgi_params文件） -
server块可覆盖部分通用值（如修改SCRIPT_FILENAME路径逻辑） -
location块最适合做精细化控制（例如为 API 接口单独设置HTTP_X_REAL_IP）
必需参数与常见误配
PHP-FPM 正常运行至少需要几个核心参数，缺一不可。最易出错的是 SCRIPT_FILENAME 和 PATH_INFO 的构造方式：
-
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;—— 必须确保$document_root指向真实文件路径，且$fastcgi_script_name是 URI 解析后的脚本路径 -
fastcgi_param PATH_INFO $fastcgi_path_info;—— 仅在启用 PATH_INFO 支持时需要，需配合fastcgi_split_path_info指令提取 - 漏掉
fastcgi_param REQUEST_METHOD $request_method;等基础变量会导致 $_SERVER 数组缺失字段
动态传参与安全边界
可通过变量动态构造参数值，但要注意变量来源可信性。例如透传真实客户端 IP：
- 前端有可信反向代理时，用
fastcgi_param REMOTE_ADDR $remote_addr;（直接取连接 IP） - 需取原始请求 IP 时，应先校验
X-Forwarded-For头是否来自可信上游，再赋值给REMOTE_ADDR或自定义变量（如HTTP_X_REAL_IP） - 避免直接将用户可控头（如
$http_user_agent）不经清洗就设为fastcgi_param，防止注入攻击
调试与验证方法
确认参数是否正确送达 PHP，不能只看 Nginx 配置语法是否通过：
- 在 PHP 脚本中打印
print_r($_SERVER);查看实际收到的 FastCGI 环境变量 - 用
nginx -t验证配置合法性，用nginx -T输出合并后的完整配置，检查参数最终值 - 开启 PHP-FPM 的
slowlog或 Nginx 的error_log debug（需编译时启用 debug 日志），观察 FastCGI 请求头传输细节
