fastcgi_param 是 nginx 向 fastcgi 后端传递请求上下文的键值映射规则，定义 nginx 变量到 fastcgi 环境变量的转换关系，需配合 fastcgi_pass 等指令并重载生效。
fastcgi_param 是 Nginx 向 FastCGI 后端（如 PHP-FPM）传递请求上下文的“翻译规则”，不是直接传数据，而是定义“哪个 Nginx 变量映射成哪个 FastCGI 环境变量”。
本质是协议层的键值映射表
FastCGI 是二进制通信协议，Nginx 和 PHP-FPM 之间不共享内存，也不直连脚本。Nginx 必须把 HTTP 请求里的信息（比如 URL、方法、头、客户端 IP）转换成标准的 FastCGI PARAMS 消息体发送过去。这个转换规则就由 fastcgi_param 指令逐条定义：
-
fastcgi_param REQUEST_METHOD $request_method;→ 把 Nginx 的$request_method（值为 GET/POST）作为REQUEST_METHOD环境变量传给 PHP，PHP 中可通过$_SERVER['REQUEST_METHOD']获取 -
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;→ 决定 PHP 实际执行哪个文件，路径拼接错误会导致 502 或空白页 -
fastcgi_param HTTPS $https;→ 当启用了 SSL 时，传on，否则为空，PHP 可据此判断是否为安全连接
消息结构决定参数如何打包
Nginx 发送 FastCGI 请求时，会构造符合协议规范的二进制帧。其中 PARAMS 类型帧（type=4）专门承载环境变量，其格式为：
- 每个变量以
key\0value\0形式连续存放（C 风格空字节分隔） - 所有 key-value 对整体作为
PARAMS帧的 payload - 帧头标明类型、长度、请求 ID，确保 PHP-FPM 能准确解析
也就是说：fastcgi_param 不是“设一个变量”，而是在组装一个标准化的参数包。漏配或错配某一项，PHP 就收不到对应字段，框架路由、权限判断、日志记录等都可能出错。
实际生效依赖完整配置链
单有 fastcgi_param 不够，它必须配合以下指令才能完成一次有效转发：
-
fastcgi_pass：指定 PHP-FPM 地址（如127.0.0.1:9000或unix:/run/php/php8.2-fpm.sock） -
fastcgi_index：当访问目录时，补全默认文件名（如index.php），影响$fastcgi_script_name的取值 - 正确的
location匹配和root设置：确保$document_root和$fastcgi_script_name能拼出真实磁盘路径
例如，若 root /var/www/html;，用户请求 /user/profile.php，Nginx 会将 $document_root$fastcgi_script_name 解析为 /var/www/html/user/profile.php —— 这个路径必须真实存在且可读，PHP-FPM 才能加载执行。
修改后必须重载才生效
fastcgi_param 属于运行时配置，修改后不会自动热更新。必须执行：
sudo nginx -t && sudo systemctl reload nginx
或
sudo nginx -s reload
否则新参数不会进入后续请求的 PARAMS 帧中，旧行为仍持续生效。
