适用系统: Debian 11 / 12 / 13
目标版本: PHP 7.4.33-31
漏洞修复: CVE-2026-109618、CVE-2026-109619
安装方式: Sury PHP APT 软件源

一、升级说明

本次使用 Sury PHP 软件源,通过 Debian APT 安装或升级 PHP 7.4,无需源码编译。

Sury 是 PHP Debian 软件包维护者提供的第三方仓库,不是 Debian 官方仓库,也不是 php.net 官方直接发布的软件包。

系统 代号 PHP 软件源
Debian 11 bullseye packages.sury.org/php
Debian 12 bookworm ackages.sury.org/php
Debian 13 trixie ackages.sury.org/php

本次目标软件包修订版为 7.4.33-31,维护方声明包含上述两个 CVE 的安全回移补丁。最终漏洞修复情况应结合软件包补丁记录及安全验证结果确认。

升级分为两种情况:

  • 情况一:未安装 PHP 7.4,直接通过 APT 安装 PHP 7.4 及所需扩展。
  • 情况二:已经安装 PHP 7.4,通过 APT 升级现有 PHP 7.4 软件包。

升级前应确认原有 PHP 版本、Apache/PHP-FPM 运行方式,并做好配置及业务数据备份。

二、环境检查及备份

2.1 检查操作系统和 PHP

查看已安装的 PHP 软件包:

检查是否已经安装 PHP 7.4:

查看当前 Apache PHP 模块:

检查 PHP-FPM:

2.2 备份相关配置

如未安装 Apache,跳过 Apache 备份。

保存原有扩展清单:

生产服务器还应确认 LIMS 程序、数据库已有可恢复的备份。

三、配置 PHP APT 软件源

3.1 安装基础依赖

如果系统已有这些工具,可以跳过。

3.2 安装 Sury 签名密钥

方式一

方式2

方式3

下载 Sury 官方密钥包:

安装:

查看密钥:

3.3 配置 PHP 软件源

先检查是否存在旧的 Sury 源配置:

如果存在重复配置,先备份并禁用多余条目。

创建软件源文件:

该配置自动识别 Debian 11/12/13 对应代号。

如果原来已配置 Sury 源,需要停用重复条目,避免签名配置冲突。

3.4 更新软件包索引

检查 PHP 7.4 候选版本:

目标版本应包含:

并与当前 Debian 版本对应:

Debian 11、12、13 对应的软件包后缀不同,应以各服务器实际显示的版本为准。

如没有符合要求的候选版本,不要继续安装或升级。

四、情况一:首次安装 PHP 7.4

适用于尚未安装 PHP 7.4 的服务器。

4.1 模拟安装

确认不会卸载原有 PHP、引入无关 PHP 版本或产生依赖冲突。

4.2 正式安装

验证:

4.3 安装 Web 运行组件

如果网站使用 Apache mod_php:

模拟无异常后:

如果网站使用 PHP-FPM:

模拟无异常后:

两种方式按照实际部署选择,不需要全部安装。

五、情况二:升级已经安装的 PHP 7.4

适用于服务器已经安装 PHP 7.4,仅需要更新到安全修订版的情况。

5.1 获取已安装软件包

上述命令自动获取已安装的 PHP 7.4 软件包,暂时排除 Imagick,以避免在部分环境中引入 PHP 8.5 等无关软件包。

5.2 模拟升级

检查是否存在意外卸载、新增 PHP 8.x 或升级无关系统组件的情况。

5.3 正式升级

在维护窗口执行:

该命令仅对已安装的软件包进行升级,不会主动安装不存在的扩展。

如果有额外安装的 PHP 7.4 第三方扩展,应另行检查升级依赖。

六、PHP 扩展安装及检查

6.1 常用扩展

PHP 扩展 作用
php7.4-mysql MySQL、MariaDB、PDO MySQL
php7.4-curl HTTP 请求
php7.4-gd 图片处理、验证码
php7.4-mbstring 中文及多字节字符串
php7.4-xml XML、DOM、XSL
php7.4-zip ZIP 压缩
php7.4-bcmath 高精度计算
php7.4-opcache PHP 性能优化
php7.4-readline CLI 交互
php7.4-intl 国际化处理
php7.4-soap SOAP 接口
php7.4-imagick ImageMagick 图片处理、格式转换

常规内置扩展由 PHP 基础组件提供,不需要单独安装。

6.2 Imagick 扩展

先检查:

如果没有安装,先模拟:

确认没有额外引入无关 PHP 版本后:

如果 Imagick 已安装,只需升级:

模拟正常后去掉 -s 正式执行。

检查:

其他第三方扩展(如 Redis、Smbclient、DS 等)按照实际业务需要单独安装。

6.3 比较新旧 PHP 扩展

例如原来使用 PHP 7.0:

输出内容为 PHP 7.0 存在、PHP 7.4 当前 CLI 没有加载的扩展。

注意:如果网站使用 Apache mod_php 或 FPM,还需要验证相应运行环境加载的扩展。

七、配置迁移及运行版本切换

7.1 PHP 配置文件位置

根据实际运行方式使用对应配置文件。

例如原来使用 PHP 7.3 Apache:

重点迁移:

不要直接覆盖整个旧版 php.ini。

参考设置(mod_php,不适用php-fpm)

7.2 切换 Apache PHP 模块

如果网站使用 Apache mod_php,原来启用 PHP 7.3:

如果原来启用 PHP 7.0,则将禁用命令改为:

7.3 PHP-FPM 切换

如果网站通过 PHP-FPM 运行,应检查:

确认 PHP 7.4 FPM 监听的 Socket 或端口:

根据实际情况调整 Apache 或 Nginx 网站配置,使其指向 PHP 7.4 FPM。

完成配置检查后,再重启或重载对应服务。

7.4 切换默认 CLI

验证:

注意:CLI PHP 与 Apache/FPM 的 PHP 版本相互独立。

八、升级完成后的验证

8.1 PHP 版本及扩展

查看已安装软件包版本:

如果安装了 Apache PHP 模块:

确认修订版本为 7.4.33-31 或经验证包含相应安全补丁的后续修订版。

8.2 软件包状态

正常情况下没有依赖错误和配置异常。

8.3 Apache/PHP-FPM 状态

Apache:

PHP-FPM:

如果对应服务没有安装,可跳过。

8.4 网站 PHP 版本

通过临时 phpinfo() 页面确认:

验证后立即删除临时页面。

九、回滚及业务验收

9.1 Apache 版本回滚

如果从 PHP 7.3 切换到 7.4 后出现业务异常:

原来使用 PHP 7.0 的服务器,则恢复对应 PHP 7.0 模块。

9.2 CLI 回滚

根据原有版本调整。

对于 PHP-FPM,应恢复原有的 Web 服务器转发配置,并重新加载对应服务。

注意:如果原来已经使用 PHP 7.4,仅升级了 PHP 7.4 软件包,回退到旧修订版需要事先保存的旧版软件包,不能通过切换 Apache 模块完成。

十、常见问题及处理

10.1 Sury GPG 密钥过期

错误:

原因: APT 使用的仓库签名密钥过期、未正确更新,或实际加载了其他旧密钥。

处理:

优先按照第三节重新安装 Sury 官方 keyring 并配置 signed-by。

如果旧源仍然出现签名问题,可重新下载有效密钥:

对应软件源:

其中 bullseye 根据操作系统版本更改。

更新:

如仍报错,可通过 gpgv 验证仓库签名:

Debian 12/13 修改为对应系统代号。

不要使用 trusted=yes 或禁用签名校验来绕过错误。

10.2 APT 软件包下载 404

错误示例:

原因: 镜像同步异常、软件包已迁移、APT 索引陈旧或代理缓存问题。

处理:

如仍然报错,可检查软件包实际下载地址和候选版本:

必要时更换为可访问且可信的 Debian 软件源,或下载经过校验的对应 .deb 本地安装。

不要使用不存在的包地址反复尝试。

10.3 apt update 成功但 PHP 版本没变化

原因: apt update 仅更新软件包索引,不会升级已安装的 PHP。

检查:

如果 Installed 为旧版本、Candidate 为新版本,需要执行第五节的升级命令。

10.4 PHP 7.4 已更新,但 php -v 还是旧版本

原因: 多版本 PHP 共存,系统默认 CLI 仍然指向旧版本。

处理:

注意该操作只改变 CLI 默认版本,不代表网站 PHP 已切换。

10.5 PHP 7.4 缺少原有扩展

原因: 新旧 PHP 扩展安装范围不同,且第三方二进制扩展通常不兼容不同的 PHP API。

处理:

再与原 PHP 扩展清单比较。

需要补装的扩展通过 APT 选择兼容 PHP 7.4 的软件包,不能直接复制旧版本 .so 文件。

10.6 APT 提示可以 autoremove PHP 相关软件包

例如:

被标记为自动安装且不再需要。

处理:

升级过程中不要直接执行:

确认仍需要的软件包后,可以设置为手动安装:

仅对实际安装且确实需要长期保留的软件包执行。