PHP-FPM用UnixSocket连接Nginx配置方法

本文详解了PHP-FPM与Nginx通过Unix Socket高效通信的关键配置要点，直击实践中高频踩坑的五大核心：精准定位PHP-FPM实际监听的Socket路径（需结合systemctl服务名与pool配置双重验证）、Nginx中fastcgi_pass必须严格带unix:前缀且路径零误差、socket文件权限与属组必须匹配Nginx worker用户、SCRIPT_FILENAME必须用$document_root动态拼接以保障路径正确性，以及整个权限链（PHP-FPM→socket→Nginx→文件系统）任一环节断裂即导致502/503/404等致命错误——这不是“调不通”的配置问题，而是“连门都进不去”的权限与协议识别底层逻辑，每一步都关乎生产环境的稳定运行。

确认 PHP-FPM 实际监听的是 Unix Socket 路径

很多人直接复制网上配置，却没看自己系统里 php-fpm 真正在听哪条 socket。不匹配就 502，没得商量。

查法很简单，先看服务名：

• systemctl list-units | grep php.*fpm（常见如 php8.1-fpm、php8.2-fpm）
• 再打开对应配置文件：/etc/php/8.1/fpm/pool.d/www.conf
• 找 listen = 这一行，典型值是：/run/php/php8.1-fpm.sock 或 /var/run/php/php8.1-fpm.sock

注意：路径前后不能有多余空格，listen.owner 和 listen.group 通常为 www-data（Ubuntu/Debian）或 nginx（CentOS/RHEL），这个决定了 Nginx worker 能不能读写它。

Nginx 的 fastcgi_pass 必须带 unix: 前缀且路径完全一致

这是最常被漏掉的细节。写成 fastcgi_pass /run/php/php8.1-fpm.sock; 是错的——少 unix: 就会当 TCP 地址解析，直接 502。

正确写法（放在 location ~ \.php$ 块内）：

location ~ \.php$ {
    include fastcgi_params;
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

关键点：

• unix: 前缀不能省，这是 Nginx 识别 Unix Socket 的唯一标识
• 路径必须和 www.conf 中 listen = 的值一字不差（包括斜杠方向、有无 /run vs /var/run）
• 如果路径含空格或特殊字符，得用引号包裹，但标准路径一般不用

检查 socket 文件权限和所属组

即使地址对了，Nginx worker 进程（通常是 www-data 或 nginx 用户）没权限读写 socket，照样连不上，报 502 或 503。

运行这条命令看实际权限：

ls -l /run/php/php8.1-fpm.sock

理想输出类似：srw-rw---- 1 root www-data 0 Apr 23 13:45 /run/php/php8.1-fpm.sock

如果 group 不是 Nginx worker 所属组，或者权限不是 rw-（即第二组的 rw），就得改：

• 改 www.conf 中的 listen.group = www-data（或 nginx）
• 改 listen.mode = 0660
• 改完 reload：sudo systemctl reload php8.1-fpm

别忘了 reload Nginx：sudo systemctl reload nginx

SCRIPT_FILENAME 拼接错误会导致 404 或源码泄露

写成 fastcgi_param SCRIPT_FILENAME /var/www/html$fastcgi_script_name; 看似能跑，但一旦站点根目录不是 /var/www/html，或者用了 alias，就崩。

必须用动态变量：

• $document_root 由 Nginx 根据当前 server 或 location 的 root 自动计算
• $fastcgi_script_name 是请求 URI 中的 .php 文件部分（如 /info.php）
• 拼起来才是真实磁盘路径，PHP-FPM 才找得到文件

漏掉这行，或写死路径，常见现象是浏览器空白、下载 .php 文件、或 Nginx 日志报 File not found。

Unix Socket 模式下最容易被忽略的其实是权限链：PHP-FPM 启动用户 → socket 文件属主/组/模式 → Nginx worker 用户 → $document_root 目录及 PHP 文件的读权限。四个环节断一个，就不是“配不配得上”，而是“压根不给你进”。

今天关于《PHP-FPM用UnixSocket连接Nginx配置方法》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于phpenv的内容请关注golang学习网公众号！