旧项目迁移到阿里云 ECS 时,可能因为代码或扩展兼容性,暂时只能使用 PHP 7。安装前要先核对操作系统和所需的小版本;安装后,还要确认 PHP-FPM 与 Nginx 已正确衔接。只在命令行里看到 PHP 版本,并不能说明网站已经能正常运行。
下面以 Ubuntu 20.04、PHP 7.4 和 Nginx 为例说明操作步骤。不同发行版的软件源、包名和服务名可能不同,不能把 Ubuntu 的命令直接套用到 Alibaba Cloud Linux 或 CentOS 上。生产服务器执行前,最好先在测试环境验证安装结果和项目兼容性。
安装前确认系统与 PHP 版本
通过 SSH 登录 ECS 后,先查看系统信息:
cat /etc/os-release
确认发行版和版本后,再核对项目要求的 PHP 小版本及扩展。项目只写“PHP 7”往往不够,部分旧代码或依赖包会要求特定小版本,升级或降级时也可能出现行为差异。先查项目配置和部署文档,再决定安装哪些组件。
还要把维护风险算进去:PHP 7 已停止官方维护,PHP 7.4 也已结束安全支持。项目如果暂时不能升级,应减少服务器对外开放的端口,及时更新系统及其他依赖,并安排后续迁移。不要为了得到某个旧版本,随意添加来历不明的软件仓库;来源不清的软件包会带来额外的维护和安全风险。
Ubuntu 20.04 安装 PHP 7.4
确认使用 Ubuntu 20.04 后,先更新软件包索引:
sudo apt update
如果网站由 Nginx 提供服务,通常通过 PHP-FPM 处理 PHP 请求。可以先安装运行服务、命令行工具和常见扩展:
sudo apt install -y php7.4-fpm php7.4-cli php7.4-mysql php7.4-curl php7.4-mbstring php7.4-xml php7.4-zip
php7.4-fpm负责接收并处理 Nginx 转发的 PHP 请求;php7.4-cli用于命令行执行 PHP。其余扩展应按项目实际依赖取舍,不必为了“装全”而一股脑安装。若项目还需要 GD、Redis 等组件,先确认对应扩展版本与 PHP 版本兼容,再安装。
安装完成后检查 PHP 版本和 FPM 服务状态:
php -v
sudo systemctl status php7.4-fpm
如果服务尚未启动,并且希望它随系统启动,可以执行:
sudo systemctl enable --now php7.4-fpm
终端显示的 PHP 版本主要用于确认命令行环境。网站请求是否能正常处理,还要检查 PHP-FPM 服务和 Nginx 配置,不能只凭 php -v 判断部署已经完成。
配置 Nginx 连接 PHP-FPM
在 Nginx 对应站点配置中添加 PHP 请求转发规则。下面是常见写法,配置文件位置和现有规则应以服务器实际情况为准:
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php7.4-fpm.sock;
}
保存后先检查 Nginx 配置语法,再重新加载服务:
sudo nginx -t
sudo systemctl reload nginx
如果检查时报错,不要直接反复修改配置。先根据提示定位配置文件和行号;如果站点访问时出现网关错误或 PHP 没有被处理,再检查 FPM 是否运行,以及 Nginx 配置里的 socket 路径是否存在。可以查看 /run/php/ 下的实际文件名。不同系统或部署方式可能使用 Unix socket,也可能通过 TCP 端口通信,路径应以当前配置为准,不能照抄后就假定一定可用。
Alibaba Cloud Linux 上的安装思路
如果 ECS 使用 Alibaba Cloud Linux 3,先用 cat /etc/os-release 确认系统版本,不要运行 Ubuntu 的 apt 命令。可以用系统的软件包管理器查询仓库中有哪些 PHP 包:
sudo dnf list php\*
仓库提供的版本符合项目要求时,再按查询结果安装 PHP-FPM、CLI 和所需扩展。安装后用 php -v 检查版本,并通过 systemctl status php-fpm 查看服务状态。具体包名和服务名可能随软件源而异;命令提示找不到包或服务时,应回到查询结果核对名称,不要按 Ubuntu 的包名猜。
如果系统仓库没有项目需要的 PHP 7 小版本,避免把多个发行版的软件源混在一起安装。可以评估使用容器镜像,或在隔离环境中构建旧版运行环境。上线前要验证 PHP 扩展、文件权限、网络访问和数据持久化等项目条件,并确认运维人员能够持续维护这套环境。生产环境还应评估迁移到仍受支持的 PHP 版本。
部署排查:命令行正常,网页却无法执行 PHP
例如,一个依赖 PHP 7.4 的旧商城部署到 Ubuntu 20.04 ECS 后,运维人员通过 php -v 确认版本正常,但浏览器访问 PHP 页面时仍下载源码。排查发现,服务器只安装了 php7.4-cli,没有安装并启动 PHP-FPM,Nginx 也缺少 FastCGI 转发配置。
补装 php7.4-fpm,在站点配置中指向实际 socket,再用 nginx -t 检查并重新加载 Nginx 后,网页才恢复正常。遇到类似问题时,先分清命令行 PHP 和网站运行环境,再依次核对 FPM 服务、socket 路径和 Nginx 规则,通常比重复安装 PHP 更有效。
安装完成后检查这些项目
- 运行
php -v,确认命令行使用的版本符合项目要求。 - 运行
php -m,检查项目依赖的扩展是否已加载;缺少扩展时,核对包名和版本。 - 查看 PHP-FPM 与 Nginx 服务状态,并通过实际站点请求验证 PHP 页面。
- 检查文件权限、日志位置和数据库连接配置;出现错误时结合 Nginx 与 PHP-FPM 日志排查。
- 检查阿里云安全组规则,只开放业务需要的端口;数据库端口不要无条件开放给公网。
- 备份站点和服务配置,并为暂用 PHP 7 的项目安排升级计划。
阿里云安装 PHP 7 时,先确认系统和软件源,再安装匹配的 PHP 包,最后验证 PHP-FPM 与 Nginx 的连接。对于暂时无法升级的旧项目,安装能否成功只是部署的一部分;端口限制、依赖维护和迁移安排也要一并考虑。