在 nginx 中配合 fastcgi 代理 php 脚本，核心做法是在 location 块中通过 fastcgi_pass 指令将请求转发给 php-fpm 进程管理器，并设置一组标准的 fastcgi_param 环境变量以传递路径和参数。这样做后，nginx 会将解析后的 php 文件交给后端处理，并将生成的 html 响应返回给客户端。如果未正确配置 script_filename 等关键参数，php 解释器将无法定位或执行正确的脚本。
Nginx 如何识别并转发 PHP 请求
Nginx 识别 PHP 请求主要依赖 location 的路径匹配规则以及 try_files 的辅助判断。当请求进入服务器时，Nginx 会根据 URI 特征（如以 .php 结尾）选择对应的 location 块。在该块内部，通过 fastcgi_pass 指定后端地址，并利用 include fastcgi_params; 加载默认的环境变量映射表。这种机制确保了只有符合特定后缀的请求才会被当作动态脚本来处理，静态资源则按常规文件服务逻辑响应。
server {
listen 80;
server_name example.com;
root /var/www/html;
location ~ \.php$ {
# 确保请求的文件存在且是普通文件
try_files $uri =404;
# 指定 FastCGI 服务地址
fastcgi_pass unix:/run/php-fpm/www.sock;
# 加载标准 FastCGI 参数
include fastcgi_params;
# 显式设置脚本文件名，防止路径错误
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
上述配置展示了最基础的 PHP 代理结构。其中 try_files $uri =404; 用于防止非法请求直接传递给 PHP 解释器，避免潜在的安全风险。 fastcgi_pass 指向了 PHP-FPM 的 Unix Socket 文件，这是本地部署时性能较高的通信方式。若使用 TCP 连接，可改为 127.0.0.1:9000。 fastcgi_param SCRIPT_FILENAME 必须明确设置为 $document_root$fastcgi_script_name，因为默认的 fastcgi_params 文件中可能不包含此变量或值不正确，导致 PHP 无法找到入口文件。
立即学习“PHP免费学习笔记（深入）”；
如何处理 PHP 脚本中的路径与查询参数
在处理 PHP 脚本时，Nginx 需要准确传递原始 URI、查询字符串以及文档根目录信息，以便 PHP 代码能正确解析用户输入和文件位置。这主要通过 fastcgi_param 指令覆盖或补充默认参数来实现。例如，QUERY_STRING 自动捕获 URL 后的参数部分，REQUEST_URI 保留完整的请求路径，而 DOCUMENT_ROOT 则提供服务器上的物理路径。这些参数共同构成了 PHP 运行时的 $_SERVER 超全局数组基础。
# 假设请求为: GET /index.php?user=admin&age=25 # 相关变量映射如下： fastcgi_param QUERY_STRING $query_string; # user=admin&age=25 fastcgi_param REQUEST_METHOD $request_method; # GET fastcgi_param CONTENT_TYPE $content_type; # (空) fastcgi_param CONTENT_LENGTH $content_length; # (空) fastcgi_param SCRIPT_NAME $fastcgi_script_name; # /index.php fastcgi_param REQUEST_URI $request_uri; # /index.php?user=admin&age=25 fastcgi_param DOCUMENT_URI $document_uri; # /index.php fastcgi_param DOCUMENT_ROOT $document_root; # /var/www/html fastcgi_param SERVER_PROTOCOL $server_protocol; # HTTP/1.1 fastcgi_param GATEWAY_INTERFACE CGI/1.1; fastcgi_param SERVER_SOFTWARE nginx/$nginx_version; fastcgi_param REMOTE_ADDR $remote_addr; fastcgi_param REMOTE_PORT $remote_port; fastcgi_param SERVER_ADDR $server_addr; fastcgi_param SERVER_PORT $server_port; fastcgi_param SERVER_NAME $server_name; # example.com
在实际应用中，开发者常需自定义某些参数以满足框架需求。例如，许多现代 PHP 框架（如 Laravel 或 Symfony）依赖 PATH_INFO 或 REDIRECT_STATUS 进行路由分发。若使用 try_files 进行伪静态重写，还需注意 fastcgi_param 的顺序，确保重写后的 URI 能正确反映在 REQUEST_URI 中。此外，对于 HTTPS 站点，应添加 fastcgi_param HTTPS on; 以便 PHP 代码能识别当前连接是否加密。
当 PHP 脚本不存在时 Nginx 的行为是什么
当请求的 PHP 脚本在磁盘上不存在时，Nginx 的行为取决于 location 块中是否配置了 try_files 指令。如果配置了 try_files $uri =404;，Nginx 会在将请求转发给 FastCGI 之前检查文件是否存在；若文件缺失，Nginx 直接返回 404 错误，不会触发 PHP 进程。这种前置检查能有效减少后端负载并防止 PHP 输出“文件未找到”的默认错误页面。若未配置 try_files，请求将被直接发送给 PHP-FPM，PHP 解释器会尝试包含该文件，通常会抛出 Warning: file_get_contents(): Failed to open stream 或致命错误，具体取决于 PHP 代码的实现逻辑。
