如何在一台服务器部署多个PHP版本?PHP-FPM多版本共存教程

现实里经常遇到这种局面:一台服务器上跑着三个网站,老站点用的是 PHP 7.4(代码没维护、升级会挂),新站点要 PHP 8.1(用了新语法),还有一个内部系统卡在 PHP 5.6 动不了。如果只能装一个 PHP,要么老站挂、要么新站起不来,于是"多版本共存"就成了刚需。好消息是,Linux 上让多个 PHP 版本同时运行并不难——每个版本跑一个独立的 PHP-FPM 服务,监听不同的 socket 或端口,Nginx 或 Apache 按站点分别转发即可。

这篇文章讲清楚多版本共存的原理和完整落地步骤:怎么安装多个 PHP 版本、怎么让它们各自作为独立服务运行、怎么配置 FPM 池、怎么在 Nginx/Apache 里让不同站点走不同版本,以及升级、切换、回滚的注意事项。文中会分别给出 RHEL/CentOS/Rocky 与 Debian/Ubuntu 的安装方式,因为两者在多版本管理上差异明显。

读完之后,你应该能在一台机器上稳定运行两到三个 PHP 版本,各站点互不干扰,并且知道出问题时(比如某站突然用了错误版本)从哪里查、怎么改。

一、多版本共存的原理

PHP 在 Web 场景下分成两部分:PHP-FPM(负责执行 PHP 代码的常驻进程管理器)和 Web 服务器(Nginx/Apache,负责把 .php 请求转发给 FPM)。所谓"多版本共存",本质是:

  • 每个 PHP 版本装一套独立的 FPM,作为独立的 systemd 服务运行;
  • 每个版本的 FPM 监听不同的 socket 文件(或不同端口),互不冲突;
  • Web 服务器在站点的 location ~ \.php$ 里,分别指向对应版本的 socket。

所以关键不在 Web 服务器,而在"每个版本一个 FPM 服务 + 一个独立 socket"。只要不把两个版本装到同一个前缀、或让它们抢同一个 socket,共存就天然成立。

再多说一句原理层面的东西:Web 服务器转发 PHP 请求时,本质是把请求交给一个"外部进程"去执行,再把结果拿回来(这就是 CGI/FastCGI 协议)。既然执行者是外部进程,那么"让不同的外部进程(不同版本的 FPM)来处理不同站点"就完全可行,Web 服务器并不关心那个进程内部用的是哪个 PHP 版本。理解了这一点,你就明白为什么多版本共存的核心配置只有一处——fastcgi_pass 指向哪个 socket。其他的安装、池配置,都是为"让每个版本的 FPM 各自健康运行"服务的。

二、两个发行版的安装思路差异

这是最容易踩坑的地方,先讲清楚。

发行版 官方仓库策略 常用做法 适用
RHEL/CentOS/Rocky 官方仓库只有一个 PHP 版本,靠 dnf module 切换 dnf module enable php:remi-8.1 等,或用 Remi 仓库 用 RPM 管理,切换是"整机级别"
Debian/Ubuntu 官方仓库可同时装多个版本(php7.4-fpm、php8.1-fpm 并存) apt install php8.1-fpm php8.0-fpm,各自独立服务 天然多版本,最省心
源码编译 完全自定义,编译到不同 --prefix ./configure --prefix=/usr/local/php81 需要特殊扩展时

RHEL 系的坑:dnf module 的 PHP 是"流"(stream)机制,同一时刻只能启用一个流,也就是说用 dnf module enable php:remi-8.1 之后,系统默认的 php 命令就指向 8.1,本机不可能通过 module 同时装两个官方 PHP。想真多版本共存,RHEL 系更常见的是用 Remi 仓库(提供 php74-php-fpm、php81-php-fpm 这种带版本前缀的包,可并存),或者干脆源码编译。

Debian/Ubuntu 系则宽松得多:apt install php8.1-fpm php7.4-fpm 会同时装两套,各自生成 php8.1-fpm.service、php7.4-fpm.service,开箱即用。

选哪种方式,其实取决于你的运维习惯和合规要求。如果是小规模、自己维护的服务器,Debian/Ubuntu 的并存方式最省心,装上就能用,版本管理靠包管理器即可。如果团队已经在用 RHEL 系并依赖 Remi 提供的丰富扩展,那就延续 Remi 的路线,注意它的包名和路径都带版本前缀,和官方文档里的路径不完全一样,网上抄配置时要留意。源码编译则留给有特殊需求(比如定制扩展、特殊编译参数)的场景,代价是你得自己维护编译、升级和 systemd 服务,长期成本不低,除非确有必要,一般不建议。无论选哪条路,都要预留足够的磁盘:一套 PHP 加上扩展通常占用几百兆到一两 GB(经验值),三四个版本叠起来也是笔不小的开销,规划时别忽略。

三、安装多个 PHP 版本

Debian / Ubuntu(推荐,最省事):

# 以 8.1 和 7.4 为例,需要先在 sources 里启用对应源(老版本可能来自第三方源)
sudo apt update
sudo apt install -y php8.1-fpm php8.1-mysql php8.1-mbstring php8.1-xml
sudo apt install -y php7.4-fpm php7.4-mysql php7.4-mbstring php7.4-xml

# 确认两个服务都在
systemctl status php8.1-fpm --no-pager
systemctl status php7.4-fpm --no-pager
# 查看监听的不同 socket
ls -l /run/php/
# 典型输出:php7.4-fpm.sock  php8.1-fpm.sock

RHEL / CentOS / Rocky(用 Remi 仓库):

# 安装 EPEL 和 Remi 仓库(以 Rocky 9 为例)
sudo dnf install -y epel-release
sudo dnf install -y https://rpms.remirepo.net/enterprise/remi-release-9.rpm

# 分别安装带版本前缀的 PHP 和 FPM(可并存)
sudo dnf install -y php81-php-fpm php81-php-cli php81-php-mysqlnd
sudo dnf install -y php74-php-fpm php74-php-cli php74-php-mysqlnd

# Remi 的包通常以 php81-php-fpm 这样的名字提供 systemd 服务
systemctl status php81-php-fpm --no-pager
systemctl status php74-php-fpm --no-pager

说明:Remi 仓库的包名与服务名会随发行版和版本略有不同,安装后用 systemctl list-units | grep php 确认真实服务名最稳妥。不要因为服务名对不上就以为装失败了。

还有一点特别提醒:同一个 PHP 版本不要同时用两种方式安装。比如已经用 Remi 装了 php81-php-*,又去编译一个 /usr/local/php81,两套配置、两套扩展、两套服务混在一起,排查问题时会极其痛苦,命令行 php 到底指向哪个都说不清。选定一种安装方式就坚持用下去,升级也走同一条路径,版本来源单一,维护起来才不折腾。

四、配置各版本的 FPM 池与监听

每个版本有自己的池配置:

; Debian 系:/etc/php/8.1/fpm/pool.d/www.conf
; RHEL/Remi:/etc/opt/remi/php81/php-fpm.d/www.conf(路径以实际为准)
[www]
user = www-data                     ; RHEL 系通常为 apache
group = www-data
listen = /run/php/php8.1-fpm.sock   ; 关键:每个版本用不同 socket
listen.owner = www-data
listen.group = www-data
listen.mode = 0660

pm = dynamic
pm.max_children = 30
pm.start_servers = 5
pm.min_spare_servers = 5
pm.max_spare_servers = 20
pm.max_requests = 500

要点:

  • listen 必须每个版本不同,否则后启动的会抢不到或覆盖。
  • user/group 要和 Web 服务器 worker 用户一致,否则 socket 权限不对,Nginx 连不上(表现为 502)。
  • pm.max_children 要按各版本实际负载分配,三个版本共享一台机器内存,别都设很大把内存吃光。经验上每个 PHP 进程占 40~60MB,用总内存反推每个池的上限。

改完重启对应服务:

# Debian 系
sudo php-fpm8.1 -t && sudo systemctl restart php8.1-fpm
# Remi 系(服务名以实际为准)
sudo systemctl restart php81-php-fpm

风险提示:重启 FPM 会短暂中断对应网站,建议低峰期操作,且改配置前先备份 www.conf,出问题立即还原重启。

五、Nginx 里让不同站点走不同版本

核心是在每个站点的 location ~ \.php$ 里指定 fastcgi_pass 到对应 socket:

# 站点 A:PHP 8.1
server {
    listen 80;
    server_name new.example.com;
    root /var/www/new/public;

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php8.1-fpm.sock;   # 指向 8.1
        fastcgi_index index.php;
        include fastcgi_params;                        # Debian: fastcgi_params / RHEL: fastcgi.conf
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

# 站点 B:PHP 7.4(老站不升级)
server {
    listen 80;
    server_name old.example.com;
    root /var/www/old;

    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;   # 指向 7.4
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    }
}

注意 include 的差异:Debian 系用 fastcgi_params,RHEL 系常用 fastcgi.conf(后者已包含 SCRIPT_FILENAME)。如果两行都写可能重复定义参数,选一套即可。改完 nginx -t 校验再 reload。

sudo nginx -t && sudo nginx -s reload

六、Apache 里让不同站点走不同版本

Apache 用 SetHandler 配合 proxy:unix 把 .php 转给指定 socket:

# 站点 A:PHP 8.1

    ServerName new.example.com
    DocumentRoot /var/www/new/public

    
        SetHandler "proxy:unix:/run/php/php8.1-fpm.sock|fcgi://localhost/"
    


# 站点 B:PHP 7.4

    ServerName old.example.com
    DocumentRoot /var/www/old

    
        SetHandler "proxy:unix:/run/php/php7.4-fpm.sock|fcgi://localhost/"
    

需要启用 proxy 和 proxy_fcgi 模块(Debian 系 a2enmod proxy proxy_fcgi),并在 Directory 里放行访问。改完用 apache2ctl configtest / httpd -t 校验再 reload。

七、验证与常见故障

验证某站到底用了哪个版本,最直接的办法是放一个探针文件(用完删掉):

# 在站点根目录放探针
echo '

常见故障与处理:

现象 可能原因 处理
访问 PHP 页面 502 socket 路径错 / FPM 没起 核对 fastcgi_pass 与 ls -l /run/php/
502 且日志报 permission denied socket 权限或属主不对 对齐 listen.owner 与 Web 用户
站点用了错误版本 fastcgi_pass 指错 socket 或有两处配置冲突 nginx -T 看最终生效配置
老站升级后功能异常 扩展缺失或行为差异 php -m 对比扩展,逐步补装
内存吃紧 多版本 max_children 之和过大 按负载下调各池上限
# 查看 Nginx 最终生效的全部配置(排查配置冲突神器)
sudo nginx -T | grep -n "fastcgi_pass"

常见问题

Q1:RHEL 系能用 dnf module 同时装两个 PHP 版本吗?
不能。module 的 PHP 是"流",同一时刻只启用一个。要多版本共存,用 Remi 仓库(带版本前缀的包)或源码编译。

Q2:两个版本会不会互相覆盖配置?
只要装在不同前缀、池配置文件不同、socket 不同,就不会。Debian 系天然隔离;RHEL/Remi 的配置在各自 phpXX 目录下。

Q3:切换某个站点的 PHP 版本要重启整台服务器吗?
不用。只需改该站点 fastcgi_pass 指向的 socket,nginx -t && nginx -s reload 即可,其他站点不受影响。

Q4:升级老站 PHP 版本前要注意什么?
先在测试环境跑一遍:检查废弃函数、扩展兼容、框架最低版本要求。生产升级保留旧版本 FPM 一段时间方便回滚——把 fastcgi_pass 改回旧 socket 即可秒回滚。

Q5:CLI 下怎么指定用哪个 PHP 版本?
用带版本的命令,如 php8.1 -v、php7.4 artisan;或用 update-alternatives 管理默认 php 指向,但注意别影响 FPM 的服务端版本。

总结

  • 多版本共存的本质是"每个 PHP 版本一个独立 FPM 服务 + 独立 socket",Web 服务器按站点分别转发,互不干扰。
  • Debian/Ubuntu 天然支持并存(php8.1-fpm、php7.4-fpm);RHEL 系要用 Remi 仓库或源码编译,dnf module 做不到同时启用多个版本。
  • 每个 FPM 池的 listen socket 必须唯一,user/group 要和 Web 用户一致,pm.max_children 要按共享内存合理分配。
  • Nginx 用 fastcgi_pass unix:/path/phpX.Y-fpm.sock、Apache 用 SetHandler "proxy:unix:..." 实现按站点选版本。
  • 切换版本只需改对应站点的 socket 指向并 reload;升级前在测试环境验证,生产保留旧版本以便秒级回滚。

最后留一句经验:多版本共存虽然方便,但也别让版本数量失控。每多一个版本,就多一份安全补丁、扩展兼容和内存开销的维护负担。合理的目标是"能合并的尽量合并",把确实升不动、又还在用的老版本单独隔离出来。等老站有了升级条件,就尽早收敛到统一版本,让运维复杂度降下来。