在香港服务器配置PHP环境,如何让Nginx正确调用PHP-FPM?
让Nginx正确调用PHP-FPM,关键是把三处配置对齐:Nginx转发请求使用的FastCGI地址、PHP-FPM实际监听的地址,以及传给PHP-FPM的脚本文件路径。安装PHP命令行工具并不代表网页已经能执行PHP,还需要让FPM服务运行,并为站点配置PHP请求入口。
下面以一台首次配置PHP环境的香港服务器为例,使用Ubuntu 24.04 LTS、发行版软件源中的Nginx与PHP 8.3,通过Unix Socket完成本机调用。目标是先跑通一个独立测试站点,不涉及数据库、框架部署或完整上线流程。服务器所在地区不会改变Nginx与PHP-FPM的调用方式,但公网验证需要额外核对安全组和本机防火墙。
围绕Nginx与PHP-FPM组成的PHP站点运行环境,A5数据提供香港物理服务器资源,覆盖入门建站、Xeon Gold及AMD EPYC等配置,配有SSD或NVMe存储,并提供不同档位的内存资源,为网站程序、业务后台及接口服务提供计算与数据读写基础。香港产品的CN2与国际带宽方案,也为面向不同访问地区的PHP业务提供相应的网络资源支持。
一、准备环境并记录原始状态
本例需要具备以下条件:
- 能通过SSH登录服务器,并拥有sudo权限。
- 操作系统为Ubuntu 24.04 LTS,使用systemd管理服务。
- 软件源可访问,服务器有可用磁盘空间。
- 没有宝塔等面板管理的Nginx、PHP环境,也没有需要保留的生产站点配置。
先确认系统,再进入root会话:
cat /etc/os-release
sudo -i
预期系统信息包含Ubuntu和VERSION_ID="24.04"。若版本不同,应先核对对应PHP包版本、服务名和Socket路径,不要直接照抄本文中的8.3。
后续命令在同一个root会话中执行。先记录安装前状态,便于判断回滚范围:
BACKUP=$(mktemp -d /root/php-fpm-first-XXXXXX)
echo "备份目录:$BACKUP"
dpkg-query -W nginx php8.3-fpm php8.3-cli \
> "$BACKUP/packages-before.txt" 2>&1
systemctl is-enabled nginx php8.3-fpm \
> "$BACKUP/enabled-before.txt" 2>&1
systemctl is-active nginx php8.3-fpm \
> "$BACKUP/active-before.txt" 2>&1
if [ -d /etc/nginx ]; then
cp -a /etc/nginx "$BACKUP/nginx-original"
fi
if [ -d /etc/php/8.3/fpm ]; then
cp -a /etc/php/8.3/fpm "$BACKUP/fpm-original"
fi
尚未安装的包或服务可能返回“未找到”,这是状态记录,不是部署失败。记下备份目录;若重新登录,需要重新设置BACKUP变量。
安装Nginx时,软件包可能自动启动默认站点。部署期间不要直接向所有来源开放80端口;需要远程验证时,可以先在服务器安全组中仅允许自己的测试出口IP。本文不修改防火墙,也不开放PHP-FPM端口。
二、安装软件并确认FPM真正运行
安装本文需要的组件:
apt update
apt install -y nginx php8.3-fpm php8.3-cli curl
这里三个组件各有职责:Nginx接收HTTP请求;PHP-FPM执行PHP脚本;PHP CLI用于检查版本与脚本语法,不能代替FPM处理网页请求。
检查安装结果:
nginx -v
php -v
/usr/sbin/php-fpm8.3 -v
systemctl status php8.3-fpm --no-pager
预期Nginx、PHP-FPM均能显示版本。php -v只说明命令行PHP的版本;如果系统存在多个PHP版本,应以FPM命令和最终网页返回结果确认网页运行环境。
修改配置前,再保存一份安装后的基线:
cp -a /etc/nginx "$BACKUP/nginx-before-site"
cp -a /etc/php/8.3/fpm "$BACKUP/fpm-before-site"
这份备份用于撤销后续站点和FPM配置变化,不等同于卸载软件包。
三、对齐Socket、访问权限和站点路径
1. 确认PHP-FPM监听地址
检查默认进程池配置:
grep -nE '^[[:space:]]*(listen|listen\.owner|listen\.group|listen\.mode)[[:space:]]*=' \
/etc/php/8.3/fpm/pool.d/www.conf
grep -nE '^[[:space:]]*user[[:space:]]' /etc/nginx/nginx.conf
本例期望FPM配置为:
listen = /run/php/php8.3-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
Nginx工作进程用户应为www-data。这样Nginx才能访问由FPM创建的Socket。
如果配置已经一致,无需修改。若不一致,编辑已有配置项,不要在文件末尾重复追加:
nano /etc/php/8.3/fpm/pool.d/www.conf
此修改会影响使用该www进程池的全部站点,因此只适用于本文的首次部署环境。回滚时可恢复备份中的www.conf。不要用chmod 777解决Socket权限问题:它会扩大访问范围,而且Socket重建后手动权限可能丢失。
检查配置并启动服务:
/usr/sbin/php-fpm8.3 -t
systemctl enable --now php8.3-fpm
systemctl reload php8.3-fpm
ls -l /run/php/php8.3-fpm.sock
ss -xl | grep -F '/run/php/php8.3-fpm.sock'
预期配置测试通过,Socket存在且处于监听状态,属主、属组为www-data。如果Socket没有出现,应先查看FPM日志,不要继续猜测Nginx路径:
journalctl -u php8.3-fpm -n 50 --no-pager
Unix Socket模式下,Nginx的fastcgi_pass必须与FPM的listen完全一致。 如果实际监听的是Socket,就不能把Nginx配置成127.0.0.1:9000。本机调用不需要向公网开放9000端口。
2. 创建独立测试目录
本例使用/var/www/php-fpm-demo和同名站点配置。先检查这些路径没有被占用:
ls -ld /var/www/php-fpm-demo \
/etc/nginx/sites-available/php-fpm-demo.conf \
/etc/nginx/sites-enabled/php-fpm-demo.conf 2>/dev/null
首次部署时应没有输出。如果已有目录、文件或链接,停止执行创建步骤,换用未占用的名称,避免覆盖现有内容。
创建测试脚本:
install -d -m 0755 /var/www/php-fpm-demo
cat > /var/www/php-fpm-demo/index.php <<'PHP'
<?php
header('Content-Type: text/plain; charset=utf-8');
echo "PHP-FPM OK\n";
echo "PHP_VERSION=" . PHP_VERSION . "\n";
echo "SAPI=" . PHP_SAPI . "\n";
PHP
chmod 0644 /var/www/php-fpm-demo/index.php
php -l /var/www/php-fpm-demo/index.php
预期语法检查返回No syntax errors detected。权限设置仅作用于本例新建的目录和文件,允许Nginx及FPM读取,不授予写入权限,也不递归修改其他站点。
3. 配置Nginx的PHP请求入口
创建独立站点配置:
cat > /etc/nginx/sites-available/php-fpm-demo.conf <<'NGINX'
server {
listen 80;
server_name php-demo.example.com;
root /var/www/php-fpm-demo;
index index.php;
access_log /var/log/nginx/php-fpm-demo.access.log;
error_log /var/log/nginx/php-fpm-demo.error.log;
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
try_files $uri =404;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
location ~ /\. {
deny all;
}
}
NGINX
ln -s /etc/nginx/sites-available/php-fpm-demo.conf \
/etc/nginx/sites-enabled/php-fpm-demo.conf
nginx -t
php-demo.example.com是示例主机名,公网使用时需要替换成实际域名。这里不删除默认站点,也不把测试站点设为默认入口,因此验证时必须使用正确的Host。
这段配置中,三个项目直接决定PHP能否执行:
| 配置项 | 作用 | 本例对应值 |
|---|---|---|
root | 确定站点文件所在目录 | /var/www/php-fpm-demo |
SCRIPT_FILENAME | 告诉FPM执行哪个脚本 | 站点目录加请求中的PHP路径 |
fastcgi_pass | 指定FPM连接地址 | /run/php/php8.3-fpm.sock |
PHP位置块中的try_files $uri =404先确认脚本存在,避免把不存在的路径交给FPM。本文不配置PATH_INFO或框架路由;后续部署具体应用时,应按应用要求调整,不能把这份验证配置当作所有框架的通用配置。

nginx -t通过后再启动或重载:
systemctl enable --now nginx
systemctl reload nginx
systemctl is-active nginx php8.3-fpm
预期两个服务均返回active。若配置测试失败,先修正报错行,不要通过重启反复尝试。
四、先在本机验收,再验证公网访问
先绕开DNS、安全组和公网链路,直接验证Nginx到PHP-FPM的调用:
curl -i -H 'Host: php-demo.example.com' \
http://127.0.0.1/index.php
成功响应应包含HTTP 200,正文形式如下;具体补丁版本以服务器安装结果为准:
PHP-FPM OK
PHP_VERSION=8.3.x
SAPI=fpm-fcgi
其中,SAPI=fpm-fcgi能确认请求经过FPM执行,而不是仅证明命令行PHP已安装。
继续检查首页和不存在的PHP文件:
curl -i -H 'Host: php-demo.example.com' \
http://127.0.0.1/
curl -i -H 'Host: php-demo.example.com' \
http://127.0.0.1/not-exist.php
预期首页返回相同测试内容,不存在的脚本返回404。若首页显示Nginx欢迎页,通常是Host不匹配或测试站点未启用,不应立即归因于FPM。
本机通过后,才从自己的电脑验证公网。未配置DNS时,可以使用:
curl -i --resolve php-demo.example.com:80:服务器公网IPv4 \
http://php-demo.example.com/index.php
将服务器公网IPv4替换为真实地址。公网结果应与本机一致。本文只完成HTTP首次运行验证,不应通过该测试入口传输密码或其他敏感数据。
五、按低风险顺序定位常见失败
先确认请求是否到达正确站点,再检查Nginx与FPM连接,最后检查脚本。不要一开始就扩大文件权限或反复重装软件。
1. 公网不通,但本机正常
检查监听端口和本机防火墙状态:
ss -ltnp | grep ':80'
ufw status
如果Nginx已监听80、本机请求正常,优先核对服务器安全组、测试来源IP、域名解析及IPv4/IPv6差异。本例只显式配置IPv4监听;若域名存在AAAA记录,还需要单独确认IPv6可达性及监听配置。
不要直接关闭整个防火墙。确需调整时,应先记录现有规则,仅放行所需来源和端口,并保留撤销该规则的方法。
2. 返回错误页面、502或403
先查看本次请求的日志:
tail -n 50 /var/log/nginx/php-fpm-demo.access.log
tail -n 50 /var/log/nginx/php-fpm-demo.error.log
journalctl -u php8.3-fpm -n 50 --no-pager
常见现象与判断如下:
| 现象或日志提示 | 优先检查 |
|---|---|
| 欢迎页、其他站点页面 | Host是否正确、配置是否启用并重载 |
| 502,提示Socket不存在 | FPM服务状态、两端Socket路径是否一致 |
| 502,连接Socket时提示权限不足 | Nginx工作用户与Socket属主、属组、模式 |
| 403 | 目录是否可遍历、首页是否存在、是否命中禁止规则 |
Primary script unknown或File not found | root、SCRIPT_FILENAME和实际文件路径 |
| 500 | PHP语法、运行时错误及FPM错误日志 |
检查路径各级权限可以使用:
namei -l /var/www/php-fpm-demo/index.php
namei -l /run/php/php8.3-fpm.sock
目录需要执行权限才能遍历,文件需要读取权限;连接Socket则还要满足Socket访问权限。这几类权限不是同一回事,不宜一次性递归放宽。
3. PHP代码被当作静态文件返回
如果浏览器下载PHP文件,或响应中出现<?php源码,说明该请求没有正确进入FastCGI处理。应立即停止该测试入口的公网访问,保留配置和日志,再检查:
nginx -T
重点核对实际命中的server、PHP位置块和fastcgi_pass。本例测试文件没有密码,但真实应用的源码可能包含敏感配置,不应继续对外暴露后再慢慢排查。nginx -T会输出全部生效配置,排障时不要直接把完整输出公开发布。
六、验收与回滚检查项
完成首次配置后,应逐项确认:
nginx -t与php-fpm8.3 -t均通过。- Nginx、PHP-FPM服务处于
active状态。 - Nginx引用的Socket与FPM实际监听地址一致。
/index.php和/返回200,正文包含PHP-FPM OK及SAPI=fpm-fcgi。- 不存在的PHP脚本返回404,响应中没有泄露PHP源码。
- 公网验证命中了测试站点,没有把FPM端口开放到公网。
测试脚本会暴露PHP版本,验收后应移出公开目录,或替换为正式应用入口:
mv /var/www/php-fpm-demo/index.php "$BACKUP/index.php.test"
此命令仅移动本文创建的测试文件;移动后首页可能返回403,这是测试入口已撤下的结果。需要再次验证时,可将文件移回原路径。
如果要撤销本次站点配置,在确认这两个路径仍属于本文测试站点后执行:
mv /etc/nginx/sites-enabled/php-fpm-demo.conf \
"$BACKUP/php-fpm-demo.enabled"
mv /etc/nginx/sites-available/php-fpm-demo.conf \
"$BACKUP/php-fpm-demo.conf.saved"
nginx -t && systemctl reload nginx
如果修改过FPM的www.conf,再恢复安装后基线:
cp -a "$BACKUP/fpm-before-site/pool.d/www.conf" \
/etc/php/8.3/fpm/pool.d/www.conf
/usr/sbin/php-fpm8.3 -t && systemctl reload php8.3-fpm
恢复前应确认部署期间没有其他人员修改同一配置,否则会覆盖后续变更。最后复查服务状态、Nginx配置和原有入口是否正常。以上回滚保留已安装的软件包;若还要恢复安装前的服务启用状态或卸载新增软件,应依据最初保存的记录单独处理,不要在已有站点可能依赖这些组件时直接卸载。
本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/3990.html



