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 更准。
