在阿里云 ECS 上部署 PHP 网站,常见做法是让 Nginx 接收浏览器请求,再把 PHP 请求转给 PHP-FPM 执行。静态图片、CSS 和 JavaScript 通常由 Nginx 直接返回;PHP-FPM 处理程序后,将结果交回 Nginx。网站若使用数据库,还需要另外配置数据库和访问权限。
这套组合不难安装,问题多出在请求链路的衔接处:域名没有指向正确的公网 IP、安全组或本机防火墙拦截了端口、Nginx 和 PHP-FPM 的通信地址不一致,或者站点目录权限设置不合适。按请求经过的顺序检查,通常比直接重装软件更快。
部署前先确认网络和目录
- 确认系统版本:先查看 ECS 使用的 Linux 发行版和版本。软件包名称、服务名称和配置文件位置会因系统而异,安装命令也不能一概照搬。
- 检查安全组:网站使用 HTTP 时按需开放 80 端口;启用 HTTPS 后再开放 443 端口。SSH 管理端口尽量限制可访问的来源 IP。
- 核对域名解析:给域名添加指向 ECS 公网 IP 的 A 记录。刚修改解析时,部分网络可能仍使用缓存中的旧记录。
- 规划站点目录:例如把网站文件放在
/var/www/example,并为站点日志安排独立目录,方便后续查看问题。
安全组控制云平台入口的网络流量,服务器本机防火墙也可能拦截请求。域名无法连接或访问超时时,两处都要检查;只看安全组,未必能找到原因。
安装 Nginx 和 PHP-FPM,并核对通信地址
可以从系统软件仓库安装 Nginx、PHP-FPM 和项目实际需要的 PHP 扩展。安装前确认项目要求的 PHP 版本,不必为了保险装上一大批用不到的扩展。安装完成后,启动服务并设置开机自启,再分别检查 Nginx 和 PHP-FPM 的运行状态。
PHP-FPM 可以通过 Unix Socket 或本机 TCP 端口接收请求。无论选哪种方式,Nginx 站点配置都要和 PHP-FPM 池配置保持一致。不同发行版的配置文件位置和 Socket 路径可能不同,应以服务器当前配置为准,不能直接套用网上示例里的路径。
下面是一个精简的 Nginx 站点配置示意。域名、网站目录和 Socket 路径都需要按实际环境修改:
server {
listen 80;
server_name example.com www.example.com;
root /var/www/example;
index index.php index.html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
fastcgi_pass unix:/实际路径/php-fpm.sock;
}
}
server_name 应填写实际访问的域名,root 则应指向网站入口目录。使用框架时,入口文件经常位于项目的 public/index.php,此时应把网站根目录设置为 public,而不是整个项目目录,减少配置文件或依赖目录被直接访问的风险。
上线前按顺序检查
- 运行 Nginx 配置语法检查。通过后再重载配置,避免错误配置影响正在提供服务的网站。
- 确认 PHP-FPM 正常运行,并核对它的监听地址与 Nginx 中的
fastcgi_pass一致。 - 检查站点目录权限。Nginx 和 PHP-FPM 运行用户需要读取程序文件;缓存、上传等目录确实需要写入时,再单独授权。
- 分别访问静态文件和 PHP 页面,确认两类请求都能得到预期响应。
- 查看 Nginx 访问日志、错误日志和 PHP-FPM 日志,留意是否有反复出现的报错。
不要为了绕过权限问题,把整个站点设置成所有用户都可写。先确认 Nginx 和 PHP-FPM 使用哪个系统用户,再检查目录属主;只给确实需要写入的目录增加权限,后续排查和维护都会更清楚。
PHP 页面出现 502 时怎么查
例如,一个小型内容站部署到阿里云 ECS 后,首页可以打开,PHP 页面却返回 502 Bad Gateway。静态首页能正常访问,说明请求已经到达 Nginx,此时可以先看 Nginx 错误日志,再核对它连接 PHP-FPM 的地址,而不是先怀疑域名解析或 PHP 程序本身。
如果日志提示 Socket 文件不存在,就检查 PHP-FPM 池配置中的监听路径。常见情况是 PHP-FPM 升级或调整配置后,Socket 路径变了,但 Nginx 仍指向旧位置。将 fastcgi_pass 改为当前监听路径,检查 Nginx 配置无误后再重载服务。若使用本机 TCP 端口,也要确认端口号与两边配置一致。
其他常见故障的排查方向
- 域名无法打开:依次检查 DNS 解析、公网 IP、安全组和服务器防火墙,并确认 Nginx 正在监听访问所用的端口。
- 页面返回 404:核对
server_name、root和请求路径。框架项目还要检查入口目录及伪静态规则是否符合项目要求。 - PHP 文件被下载或显示源码:检查 PHP 的 location 配置和 FastCGI 转发是否生效。排查期间先限制外部访问,避免 PHP 源码暴露。
- 文件上传失败:核对 PHP 上传大小限制、执行超时和上传目录权限。权限只调整到所需目录,不要扩大到整个站点。
- 改配置后服务异常:先做语法检查,再重载服务。生产环境中不要跳过验证直接重启,以免配置错误扩大影响。
日常维护别漏掉安全和备份
正式网站应启用 HTTPS,并按需更新系统、Nginx、PHP 和项目依赖。生产环境建议关闭向访客展示 PHP 错误的设置,把详细错误写入访问受限的日志,避免路径和运行信息直接暴露。网站文件和数据库也应定期备份,并确认备份能够恢复;只保存备份文件,并不能证明恢复流程可用。
阿里云 nginx php 部署完成后,遇到故障可以沿着“域名与网络入口—Nginx—PHP-FPM—程序和目录权限”的顺序逐段验证。端口、监听地址和日志信息往往能直接缩小范围,不必一上来就重装服务或放宽全部目录权限。