PHP怎样在Nginx配PHP_FPM_Nginx配PHP_FPM方法【联动】

php在nginx下运行必须通过PHP-FPM中转，核心是Nginx的fastcgi_pass与PHP-FPM的listen地址严格匹配（如unix:/run/php/php8.1-fpm.sock），并正确设置SCRIPT_FILENAME为$document_root$fastcgi_script_name，同时确保PHP-FPM已启动且Nginx有socket读写权限。

PHP 要在 Nginx 下运行，必须通过 PHP-FPM（FastCGI Process Manager）中转请求，Nginx 本身不解析 .php 文件。配置本质是让 Nginx 把 PHP 请求转发给 PHP-FPM 的监听地址（Unix socket 或 TCP 端口），两者“联动”靠的是 FastCGI 协议，不是进程通信或共享内存。

确认 PHP-FPM 是否已安装并运行

很多新手卡在这一步：以为装了 PHP 就自动有 PHP-FPM，其实某些发行版（如 ubuntu）需单独安装 php-fpm 包，且默认不启动。

• 检查是否安装：php-fpm -v 或 systemctl list-units | grep php
• 常见服务名是 php8.1-fpm、php7.4-fpm，取决于你装的版本，用 systemctl status php*-fpm 查看状态
• 若未运行，执行 sudo systemctl start php8.1-fpm 并设开机自启：sudo systemctl enable php8.1-fpm
• 注意：PHP-FPM 默认监听 /run/php/php8.1-fpm.sock（Unix socket），不是 127.0.0.1:9000；后者需手动改 www.conf

Nginx 配置中 fastcgi_pass 必须匹配 PHP-FPM 监听地址

fastcgi_pass 是联动核心，写错就 502 Bad gateway。它必须和 PHP-FPM 实际监听的地址完全一致，包括路径权限、协议类型（socket vs TCP）。

• 查 PHP-FPM 监听地址：打开 /etc/php/8.1/fpm/pool.d/www.conf，找 listen = 行，常见值为：/run/php/php8.1-fpm.sock 或 127.0.0.1:9000
• 对应 Nginx 配置片段（放在 server 块内）：

  location ~ .php$ {     include fastcgi_params;     fastcgi_pass unix:/run/php/php8.1-fpm.sock;  # 必须和 www.conf 中 listen 值一致     fastcgi_index index.php;     fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; }

• 如果 PHP-FPM 改成监听 TCP（比如 listen = 127.0.0.1:9000），Nginx 就得写 fastcgi_pass 127.0.0.1:9000;
• Unix socket 路径要确保 Nginx worker 进程有读写权限（通常属组 www-data，socket 文件权限为 srw-rw----）

fastcgi_param SCRIPT_FILENAME 必须动态拼出真实 PHP 文件路径

这个参数告诉 PHP-FPM “具体执行哪个文件”，写死或漏掉会导致 404 或直接输出 PHP 源码（即没进 PHP-FPM）。

立即学习“PHP免费学习笔记（深入）”；

• 不能写成 fastcgi_param SCRIPT_FILENAME /var/www/html$fastcgi_script_name; —— 这样无法适配多目录或多 server 块
• 必须用 $document_root$fastcgi_script_name，因为 $document_root 由当前 server 或 location 的 root 指令决定，才准确
• 还要确认 Nginx 的 root 已正确定义，例如：root /var/www/html;，否则 $document_root 为空
• 额外建议：加一行 fastcgi_param PHP_VALUE "upload_max_filesize=64M n post_max_size=64M"; 可覆盖 php.ini 设置（可选）

联动失败最常出现在三处：PHP-FPM 没跑起来、fastcgi_pass 地址不匹配、SCRIPT_FILENAME 拼错了路径。调试时优先看 Nginx Error log（/var/log/nginx/error.log），里面会明确写 “connect() to … failed” 或 “No input file specified”，比浏览器 502 更准。