一、升级方案说明

1.1 背景

Debian 9/10 已结束常规维护,Sury PHP 公共软件源不再提供对应的发行版仓库,原有 PHP 7.0/7.3 无法直接通过该源升级至 PHP 7.4。

本次采用 GitHub 项目 Niek/php7 提供的预编译 .deb 软件包,通过 APT 本地安装。

该方式具有以下特点:

  • 无需手动编译 PHP。
  • 不需要升级 Debian 操作系统。
  • 使用 APT 管理安装和依赖。
  • PHP 7.0、7.3、7.4 可以并存。
  • 支持 Apache 模块和 PHP-FPM。
  • 项目声明已回移两个 CVE 的安全补丁。

注意:这属于第三方维护构建,并非 PHP 官方发行的安全更新。项目没有运行完整 PHP 测试套件,不能保证修复其他历史安全漏洞。后续仍需安排操作系统及 PHP 正式升级。

1.2 软件包下载地址

项目地址:

发布页面:

对应软件包:

系统 压缩包
Debian 9 php7.4-debian9-amd64.tar.xz
Debian 10 php7.4-debian10-amd64.tar.xz

下载时必须选择对应操作系统版本,不要混用。

二、安装前检查

2.1 检查操作系统

应确认:

  • Debian 9 或 Debian 10。
  • CPU 架构为 amd64。

2.2 检查原有 PHP

检查 Apache:

确认原来启用的是 PHP 7.0、7.3,还是其他版本。

如果Apache2 是编译安装的,则需要根即编译目录修改查询命令。

2.3 备份配置

生产环境还需要备份 LIMS 程序及数据库,并确认可以回滚。

建议保存原有扩展清单:

三、下载 PHP 7.4 软件包

3.1 Debian 10

3.2 Debian 9

3.3 解压及校验

所有文件应显示 OK。如有失败,不要安装。

校验和只能证明文件与清单一致,正式用于生产时还应核对 GitHub Release 公布的摘要及来源。

查看软件包:

检查版本:

Debian 10 已验证版本:

Debian 9 应确认版本包含 debian9 标识,并重新检查依赖,不能套用 Debian 10 的依赖结论。

四、安装 PHP 7.4 及常用扩展

4.1 扩展清单

本次选择安装以下常用 PHP 扩展:

软件包 用途 安装情况
php7.4-common 基础组件 已包含
php7.4-cli 命令行运行 已包含
php7.4-json JSON 处理 已包含
php7.4-mysql MySQL、MariaDB、PDO MySQL 已包含
php7.4-curl HTTP 请求 已包含
php7.4-gd 图片处理、验证码 已包含
php7.4-mbstring 中文及多字节字符 已包含
php7.4-xml XML、DOM、SimpleXML、XSL 已包含
php7.4-zip ZIP 压缩 已包含
php7.4-bcmath 高精度计算 已包含
php7.4-opcache 字节码缓存 已包含
php7.4-readline 命令行交互 已包含
php7.4-intl 国际化处理 已包含
php7.4-soap SOAP 接口 已包含
php7.4-imagick ImageMagick 图片处理、格式转换及 PDF 图片处理 未包含

其中,常见的 calendar、ctype、fileinfo、openssl、PDO、session、sockets、sodium 等由 PHP 基础组件提供,不必分别寻找同名独立软件包。

Imagick 安装说明:

Imagick 属于第三方 PECL 扩展,不包含在本次 Niek/php7 发布的 .deb 软件包中。

Debian 9/10 系统中通过 apt install php-imagick 获取的旧软件包,可能是针对系统默认 PHP 版本构建的,不能直接认为兼容 PHP 7.4。

如 LIMS 业务需要 Imagick,必须单独安装适用于 PHP 7.4(API 20190902)的扩展软件包。

检查:

如果没有安装,应输出 NOT INSTALLED。

4.2 先模拟安装

检查 APT 输出中是否出现卸载旧 PHP、升级核心系统库或依赖冲突。

Debian 10 本次现场模拟安装没有卸载旧 PHP,自动依赖额外包括 libonig5。

4.3 正式安装

确认模拟结果无异常后:

此命令不包含 Imagick,Imagick 需根据对应系统、PHP API 及业务需求另外安装。

本步骤先不安装 Apache PHP 模块,避免提前切换网站运行环境。

五、关于第三方扩展

本次 Debian 10 原有 PHP 环境使用了以下第三方扩展:

扩展 功能 本次处理
ds 特殊数据结构 暂不安装
smbclient / libsmbclient Windows SMB 文件共享 暂不安装
ps PostScript 文档 暂不安装
sass Sass/SCSS 编译 暂不安装
tideways PHP 性能分析 暂不安装
uploadprogress 文件上传进度 暂不安装
wddx WDDX 数据序列化 暂不安装
imagick 图片处理、格式转换及部分 PDF 图片处理 按业务需要单独安装

以上扩展不是 PHP 7.4 的基础运行依赖。只要业务代码没有使用,可以不安装。

注意:

  1. PHP 7.3 与 PHP 7.4 的扩展 API 不同。
  2. 不能直接将旧版本的 .so 复制到 PHP 7.4 扩展目录。
  3. wddx 从 PHP 7.4 核心发行包移除。
  4. 本项目不提供 PECL 第三方扩展。
  5. Imagick、Redis 等扩展必须单独寻找经过兼容验证的 PHP 7.4 软件包。

PHP 扩展 API:

  • PHP 7.3:20180731
  • PHP 7.4:20190902

六、安装 Apache PHP 7.4 模块

6.1 安装 Apache 模块

模拟无异常后,在维护窗口执行:

Debian 10 安装时显示:

说明 PHP 7.4 Apache 模块已经安装,但 PHP 7.3 正在使用,因此没有自动启用 PHP 7.4。

6.2 PHP 配置目录

主要路径:

6.3 迁移 PHP 配置

如果原系统使用 PHP 7.0,则将源路径改为 PHP 7.0。

重点检查:

应按照原有业务参数逐项迁移,不要直接覆盖整个 php.ini。

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

6.4 切换 Apache 到 PHP 7.4

如果Apache2 是编译安装的,则需要根即编译目录修改查询命令。

如果原来使用 PHP 7.3:

如果原来使用 PHP 7.0,则对应执行 a2dismod php7.0。

PHP-FPM 环境不能直接套用上述切换命令。

6.5 验证

网站 phpinfo() 应确认:

验证后删除临时测试页面。

七、安装完成后的检查

检查软件包:

检查 Imagick:

如果 Imagick 已正确安装,第二条命令应显示扩展详细信息及对应的 ImageMagick 版本。

比较 PHP 7.3 与 PHP 7.4 扩展:

检查默认版本:

注意 CLI 和 Apache 实际运行版本可能不同。

八、CVE 漏洞修复验证

8.1 涉及漏洞

  • CVE-2026-109618
  • CVE-2026-109619

本次使用的第三方 PHP 7.4.33 revision 31 源码声明包含两个 CVE 的安全回移补丁。

修复涉及禁用内部 session upload-progress tracking,普通文件上传功能仍可使用。

8.2 检查构建日志

本次构建日志发现:

检查命令:

构建信息:

8.3 检查安装版本

九、常见问题及处理

9.1 Sury 软件源 404

原因:Sury 公共仓库已不提供 Debian 10 buster 目录。

查找软件源:

停用失效源,不要直接改为 Debian 11 的 bullseye 源。

9.2 APT 提示 _apt 权限不足

通常因为 .deb 位于 /home/php/php74/,属于非致命提示。

9.3 安装后 PHP 默认版本变化

选择原 PHP 版本或 PHP 7.4。

9.4 安装 Apache PHP 7.4 后仍使用 PHP 7.3

切换前确认 PHP 配置及 Apache 运行模式。

9.5 PHP 7.4 缺少 Imagick

检查:

如果没有输出,说明当前 CLI 未加载 Imagick。

不要直接使用旧 PHP 7.0/7.3 的 Imagick .so。

应寻找适配 Debian 9/10 系统库、PHP 7.4 API 20190902 的 Imagick 安装包,并通过 APT 安装后检查模块及业务功能。

9.6 SHA256 校验失败

如出现 FAILED,停止安装,核实来源并重新下载。

9.7 缺少 libonig5(Debian10)

服务器实际报错:

首先尝试 APT 安装:

如果客户服务器不能访问外网,在另一台机器下载:

上传至服务器后:

随后重新安装 PHP 7.4。

Debian 9 的依赖版本必须单独检查。

9.8 缺少 libsodium23(Debian10)

服务器实际报错:

原因:PHP 本地安装包已被 APT 识别,但当前环境无法满足 libsodium23 依赖。服务器无外网、源索引不可用或无候选版本,都可能导致这一结果。

末句“保持现状”是 APT 通用报错,不能仅据此认定软件包被锁定。只有补齐依赖后仍存在冲突,再结合 apt-mark showhold、apt-cache policy 等结果排查。

首先尝试 APT 安装:

如果客户服务器不能访问外网,在另一台机器下载:

上传至服务器后:

随后重新安装 PHP 7.4。

Debian 9 的依赖版本必须单独检查。

9.9 缺少 libicu63(Debian10)

服务器实际报错:

libicu63 是 Debian 10 对应的 ICU 运行库。两者有版本区别,不能简单互换。

APT 安装(推荐)

如果客户服务器不能访问外网,在另一台机器下载:

上传至服务器后:

随后重新安装 PHP 7.4。

Debian 9 的依赖版本必须单独检查。

9.10 缺少 libonig4(Debian9)

服务器实际报错:

libicu63 是 Debian 9 是 Oniguruma 正则表达式库,主要用于 PHP 的 mbstring 扩展。

APT 安装(推荐)

如果客户服务器不能访问外网,在另一台机器下载:

上传至服务器后:

随后重新安装 PHP 7.4。

Debian 10 的依赖版本必须单独检查。

9.11 缺少 libsodium18(Debian9)

服务器实际报错:

libsodium18 是 Debian 9 是 Sodium 加密库,用于 PHP 的 Sodium 加密功能。

APT 安装(推荐)

如果客户服务器不能访问外网,在另一台机器下载:

上传至服务器后:

随后重新安装 PHP 7.4。

Debian 10 的依赖版本必须单独检查。

9.12 PHP 7.4 Imagick 扩展安装(Debian 10)

问题说明

通过 Niek/php7 提供的 DEB 安装 PHP 7.4 后,可能缺少 Imagick 扩展。该扩展需单独安装与系统版本、PHP API 和 CPU 架构匹配的 DEB 软件包。

1. 检查系统及 PHP 环境

PHP 7.4 扩展 API 为 20190902,不能直接使用 PHP 7.0 的 imagick.so。

2. 下载 Imagick DEB 安装包

历史 Sury 镜像地址:

找到 Debian 10 amd64 对应的 php7.4-imagick 3.7.0-4 安装包。

选择时注意:

  • Debian 9/10 选择对应系统版本的 DEB,不能混用。
  • ARM 架构选择 arm64 或 armhf,不能使用 amd64。
  • Debian 9 和 ARM 的可用历史包尚未确认。

3.上传至服务器检查安装包

确认扩展目录为 /usr/lib/php/20190902/,且依赖库版本满足要求。

4. 模拟并正式安装

确认没有依赖错误或异常卸载后:

5. 验证扩展

如 Apache 使用 PHP 7.4,在维护窗口执行:

注意: 第三方历史镜像软件包需校验来源及哈希;安装前应确认 Debian 版本、CPU 架构、PHP API 和 ImageMagick 依赖均匹配。

 

 

 

 

 

十、Apache PHP 版本回滚

如果升级后 LIMS 发生异常,原 PHP 7.3 仍保留时,可以切回:

如果原来使用 PHP 7.0,则对应切回 PHP 7.0。

必要时恢复备份的 PHP 与 Apache 配置。