一、安装说明

本次使用 PHP 官方提供的 PHP 7.4 安全补丁源码分支,编译安装 PHP 7.4,修复 CVE-2026-109618 和 CVE-2026-109619。

采用独立目录安装,不覆盖原 PHP ,升级成功后再切换 Apache 和 PHP-FPM 服务。

1.1 目录规划

用途 路径
PHP 源码 /usr/local/src/php-7.4-fixed
PHP 7.4 安装目录 /usr/local/lib/php/7.4-CVE-2026-109618-109619
PHP 配置目录 安装目录/etc
php.ini 扫描目录 安装目录/etc/php.d
PHP-FPM 主配置 安装目录/etc/php-fpm.conf
PHP-FPM 进程池配置 安装目录/etc/php-fpm.d/www.conf
新 systemd 服务 /etc/systemd/system/php-fpm-7.4-CVE-2026-109618-109619.service
新 PHP-FPM 测试端口 127.0.0.1:9001(测试完成之后可以改为默认的9000)
旧 PHP-FPM 端口(如果有) 通常为 127.0.0.1:9000,以实际为准

1.2 操作注意事项

  1. 编译前备份原 PHP 配置及 systemd 服务。
  2. 新 PHP 使用独立安装目录。
  3. 新旧 PHP-FPM 先分别监听不同端口。
  4. 验证新 PHP 正常后再修改 Apache。
  5. 升级完成后保留 PHP 7.3,以便出现问题时回滚。

二、升级前检查与备份

2.1 查看系统和 PHP 环境

查看 PHP-FPM 服务:

查看监听端口:

检查 Apache 使用 PHP-FPM 还是 mod_php:

本手册的服务切换步骤适用于 PHP-FPM;如果现场使用 mod_php,需要另行调整 Apache 模块配置。

2.2 备份配置

原路径及服务名称应根据实际环境调整。

同时备份 Apache 虚拟主机配置,并保存旧 PHP-FPM 的监听地址、运行用户和进程参数。

三、下载 PHP 7.4 安全修复源码

3.1 源码地址

PHP 官方原始 PHP 7.4.33 源码:

注意:这是 2022 年发布的原始源码,不包含 2026 年这两个 CVE 的安全修复。

本次使用 PHP 官方安全修复分支:

GitHub 源码压缩包:

3.2 下载源码

方式一:wget 下载。

方式二:Git 下载(推荐,便于记录提交版本)。

建议保存源码提交 ID 和下载文件的 SHA256 值,方便以后审计。

3.3 检查源码

以上目录和文件存在,说明取得了 PHP 源码树。

如果使用 Git 下载,还应确认:

安全补丁核验应以该分支的实际修复提交及代码差异为依据,而不能仅依赖源码目录名称。

四、安装 PHP 编译环境

4.1 安装基础编译工具

麒麟、RPM 系 Linux:

对于 imagick 扩展,你还需要安装 ImageMagick 开发库:

不同麒麟版本的软件源可能不存在某些软件包,需要根据实际情况分别安装,不能跨系统强行安装不兼容的 RPM。

3.2 检查工具

PHP 7.4 GitHub 源码需要生成构建文件,所以对编译工具的要求与普通 PHP 发布版源码包略有区别。

五、生成 configure 并配置 PHP

5.1 生成 configure

GitHub 源码需要先生成 configure 文件:

验证:

5.2 检查依赖

如果 Oniguruma 使用源码安装,且安装在 /usr/local/oniguruma:

如果库位于 lib64,需相应调整路径。

5.3 PHP 7.4 完整 configure 命令

5.4 确认配置完成

正常完成后会显示:

确认没有 configure: error,并检查是否出现 unrecognized options。

如有错误,参考第十一章。

六、编译及安装 PHP 7.4

6.1 编译

根据服务器 CPU 和可用内存调整并行数量。

6.2 编译后检查

检查扩展:

重点确认:

可运行 PHP 自带测试:

如果存在失败的测试,需要分析原因,不应直接忽略。

6.3 安装

注: 如果需要重新编译php, 清理旧编译环境

添加环境变量

七、配置 PHP 7.4

7.1 配置 php.ini

源码目录复制 PHP 配置文件模板

修改php.ini

如果是金仓数据库的话,需要在文件最后引入金仓的PHP扩展,扩展目录以实际为准。

以上为参考值,正式部署应优先保留客户原有业务参数。

7.2 修改php-fpm(如果使用)

php配置文件目录  /usr/local/lib/php/7.4-CVE-2026-109618-109619/etc/

配置php-fpm.conf

php配置文件目录复制php-fpm.conf配置文件模板

修改php-fpm.conf

配置www.conf

php配置文件目录复制php-fpm.conf配置文件模板

修改www.conf

7.3 设置.log 日志轮转

每一项含义

配置 含义
daily 每天轮转
rotate 99 保留 99 份
compress 压缩旧日志
delaycompress 延迟一轮再压缩
copytruncate 不中断 php-fpm
create 自动创建新日志
missingok 文件不存在不报错
notifempty 空文件不轮转

八、创建 PHP 7.4 systemd 服务

8.1 新建服务

添加以下内容

8.2 重新加载 systemd 配置,使新服务生效:

8.3 启动并启用服务

8.4 设置服务为开机自启动:

8.5 管理服务

8.6 查看日志:

8.7 检查监听:

九、Apache 切换及 旧PHP 清理

9.1 修改 Apache

查找原 PHP-FPM 配置:

原配置示例:

改为:

如果现场使用 Unix Socket,应按照实际配置修改。

测试 Apache:

无错误后重载(服务名称以实际为准):

源码编译 Apache 应使用对应的 apachectl -k graceful 或现场 systemd 服务。

9.2 停止 PHP 7.3 服务

确认 PHP 7.4 正常后:

查看旧服务路径:

如果确认是自己创建的 systemd 服务文件,可以备份后移除:

刷新:

不要立即删除旧 PHP 安装目录。

9.3 回滚方案

若 PHP 7.4 导致业务异常:

  • 恢复 PHP 7.3 的 systemd 服务文件(如已移走)。
  • 将 Apache PHP-FPM 转发地址改回原来的 9000。
  • 检查 Apache 配置。
  • 启动旧 PHP 7.3。
  • 重载 Apache 并重新验证 。

参考命令:

实际操作时以现场的 Apache 服务名及原 PHP-FPM 端口为准。

十、常见问题及处理

本章节集中记录 PHP 7.4 编译、安装及运行过程中遇到的故障,后续可以持续添加新的问题。

10.1 缺少 configure 文件

报错:

原因: GitHub 下载的 PHP 源码需要生成 configure。

处理:

10.2 缺少 re2c

报错:

原因: 服务器缺少 re2c 编译工具。

处理:

优先:

如果软件源没有,源码安装。

下载地址:

验证:

必要时:

安装后返回 PHP 源码目录,重新配置 PHP。

10.3 缺少 Oniguruma

报错:

原因: PHP 7.4 的 mbstring 扩展需要 Oniguruma 开发库。

处理方式一:yum 安装

验证:

处理方式二:源码安装

官方下载地址:

设置路径:

验证:

如果运行时找不到动态库,检查实际安装路径:

如果库位于 /usr/local/oniguruma/lib,可以配置:

实际为 lib64 时,需要调整路径。