FastCGI 参数详解

FastCGI 参数是 Nginx 将请求信息传递给 PHP-FPM 或其他 FastCGI 服务的关键配置，通过合理设置可以保证动态请求正确处理。

一、标准 fastcgi_param

Nginx 官方提供了 fastcgi_params 文件，常见参数如下：

二、常用 fastcgi_param 配置示例

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    fastcgi_param PHP_VALUE "open_basedir=/var/www/html";
}

`

说明

• SCRIPT_FILENAME：必需，指定 PHP-FPM 执行脚本路径
• fastcgi_param PHP_VALUE：可设置 PHP 配置参数，如 open_basedir、upload_max_filesize 等
• 其他参数可通过 include fastcgi_params 自动加载，确保 PHP-FPM 正确识别请求信息

三、自定义 FastCGI 参数

可以根据业务需求自定义参数传递给后端应用：

fastcgi_param CUSTOM_VAR "my_custom_value";

PHP 中通过 $_SERVER['CUSTOM_VAR'] 获取该值。

掌握 FastCGI 参数详解，能够精确控制 Nginx 与 PHP-FPM 之间的请求传递与处理，确保动态请求稳定高效。