Debian 9 / Debian 10 PHP 7.4 安装升级
|
1 2 3 4 5 |
适用系统: Debian 9(Stretch)、Debian 10(Buster) CPU 架构: amd64(x86_64) 目标 PHP: 7.4.33 软件包版本: 1:7.4.33-31+php7.2~debian10.1(Debian 10) 涉及漏洞: CVE-2026-109618、CVE-2026-109619 |
一、升级方案说明
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 软件包下载地址
项目地址:
|
1 |
https://github.com/Niek/php7 |
发布页面:
|
1 |
https://github.com/Niek/php7/releases |
对应软件包:
| 系统 | 压缩包 |
| Debian 9 | php7.4-debian9-amd64.tar.xz |
| Debian 10 | php7.4-debian10-amd64.tar.xz |
下载时必须选择对应操作系统版本,不要混用。
二、安装前检查
2.1 检查操作系统
|
1 2 |
cat /etc/os-release dpkg --print-architecture |
应确认:
- Debian 9 或 Debian 10。
- CPU 架构为 amd64。
2.2 检查原有 PHP
|
1 2 3 |
php -v php -m dpkg -l | grep -E 'php|libapache2-mod-php' |
检查 Apache:
|
1 2 3 |
apache2ctl -M | grep -E 'php|mpm' ls -l /etc/apache2/mods-enabled/*php* |
确认原来启用的是 PHP 7.0、7.3,还是其他版本。
如果Apache2 是编译安装的,则需要根即编译目录修改查询命令。
2.3 备份配置
|
1 2 3 |
mkdir -p /home/php/php74-backup cp -a /etc/php /home/php/php74-backup/ cp -a /etc/apache2 /home/php/php74-backup/ |
生产环境还需要备份 LIMS 程序及数据库,并确认可以回滚。
建议保存原有扩展清单:
|
1 |
php -m > /home/php/php74-backup/php-modules.txt |
三、下载 PHP 7.4 软件包
3.1 Debian 10
|
1 2 3 |
mkdir -p /home/php/php74 cd /home/php/php74 curl -fL https://github.com/Niek/php7/releases/download/v7.4.33-2/php7.4-debian10-amd64.tar.xz -o php7.4.tar.xz |
3.2 Debian 9
|
1 2 3 |
mkdir -p /home/php/php74 cd /home/php/php74 curl -fL https://github.com/Niek/php7/releases/download/v7.4.33-2/php7.4-debian9-amd64.tar.xz -o php7.4.tar.xz |
3.3 解压及校验
|
1 2 |
tar -xJf php7.4.tar.xz sha256sum -c SHA256SUMS |
所有文件应显示 OK。如有失败,不要安装。
校验和只能证明文件与清单一致,正式用于生产时还应核对 GitHub Release 公布的摘要及来源。
查看软件包:
|
1 |
ls -lh *.deb |
检查版本:
|
1 |
dpkg-deb -f ./php7.4-common_*.deb Package Version Architecture Depends |
Debian 10 已验证版本:
|
1 2 3 |
Package: php7.4-common Version: 1:7.4.33-31+php7.2~debian10.1 Architecture: amd64 |
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)的扩展软件包。
检查:
|
1 2 |
php7.4 -m | grep -i imagick php7.4 -r 'echo class_exists("Imagick") ? "OK\n" : "NOT INSTALLED\n";' |
如果没有安装,应输出 NOT INSTALLED。
4.2 先模拟安装
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 |
cd /home/php/php74 apt -s install \ ./php7.4-common_*.deb \ ./php7.4-cli_*.deb \ ./php7.4-json_*.deb \ ./php7.4-mysql_*.deb \ ./php7.4-curl_*.deb \ ./php7.4-gd_*.deb \ ./php7.4-mbstring_*.deb \ ./php7.4-xml_*.deb \ ./php7.4-zip_*.deb \ ./php7.4-bcmath_*.deb \ ./php7.4-opcache_*.deb \ ./php7.4-readline_*.deb \ ./php7.4-intl_*.deb \ ./php7.4-soap_*.deb |
检查 APT 输出中是否出现卸载旧 PHP、升级核心系统库或依赖冲突。
Debian 10 本次现场模拟安装没有卸载旧 PHP,自动依赖额外包括 libonig5。
4.3 正式安装
确认模拟结果无异常后:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
apt install \ ./php7.4-common_*.deb \ ./php7.4-cli_*.deb \ ./php7.4-json_*.deb \ ./php7.4-mysql_*.deb \ ./php7.4-curl_*.deb \ ./php7.4-gd_*.deb \ ./php7.4-mbstring_*.deb \ ./php7.4-xml_*.deb \ ./php7.4-zip_*.deb \ ./php7.4-bcmath_*.deb \ ./php7.4-opcache_*.deb \ ./php7.4-readline_*.deb \ ./php7.4-intl_*.deb \ ./php7.4-soap_*.deb |
此命令不包含 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 的基础运行依赖。只要业务代码没有使用,可以不安装。
注意:
- PHP 7.3 与 PHP 7.4 的扩展 API 不同。
- 不能直接将旧版本的 .so 复制到 PHP 7.4 扩展目录。
- wddx 从 PHP 7.4 核心发行包移除。
- 本项目不提供 PECL 第三方扩展。
- Imagick、Redis 等扩展必须单独寻找经过兼容验证的 PHP 7.4 软件包。
PHP 扩展 API:
- PHP 7.3:20180731
- PHP 7.4:20190902
六、安装 Apache PHP 7.4 模块
6.1 安装 Apache 模块
|
1 2 |
cd /home/php/php74 apt -s install ./libapache2-mod-php7.4_*.deb |
模拟无异常后,在维护窗口执行:
|
1 |
apt install ./libapache2-mod-php7.4_*.deb |
Debian 10 安装时显示:
|
1 2 3 |
Creating config file /etc/php/7.4/apache2/php.ini libapache2-mod-php7.4: php7.3 module already enabled, not enabling PHP 7.4 |
说明 PHP 7.4 Apache 模块已经安装,但 PHP 7.3 正在使用,因此没有自动启用 PHP 7.4。
6.2 PHP 配置目录
|
1 2 3 4 5 6 7 8 9 10 11 |
/etc/php/ ├── 7.0/ ├── 7.3/ └── 7.4/ ├── apache2/ │ ├── php.ini │ └── conf.d/ ├── cli/ │ ├── php.ini │ └── conf.d/ └── mods-available/ |
主要路径:
|
1 2 3 4 5 6 |
/usr/bin/php7.4 /etc/php/7.4/cli/php.ini /etc/php/7.4/apache2/php.ini /etc/php/7.4/mods-available/ /usr/lib/php/20190902/ /usr/lib/apache2/modules |
6.3 迁移 PHP 配置
|
1 2 3 |
diff -u \ /etc/php/7.3/apache2/php.ini \ /etc/php/7.4/apache2/php.ini |
如果原系统使用 PHP 7.0,则将源路径改为 PHP 7.0。
重点检查:
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
memory_limit max_execution_time max_input_time max_input_vars post_max_size upload_max_filesize upload_tmp_dir date.timezone error_reporting display_errors log_errors error_log session.save_path |
应按照原有业务参数逐项迁移,不要直接覆盖整个 php.ini。
参考设置(mod_php,不适用php-fpm)
|
1 2 3 4 5 6 7 |
date.timezone = Asia/Shanghai max_execution_time = 300 max_input_time = 300 max_input_vars = 50000 memory_limit = 2048M post_max_size = 256M upload_max_filesize = 200M |
6.4 切换 Apache 到 PHP 7.4
|
1 2 |
apache2ctl -M | grep -E 'php|mpm' ls -l /etc/apache2/mods-enabled/*php* |
如果Apache2 是编译安装的,则需要根即编译目录修改查询命令。
如果原来使用 PHP 7.3:
|
1 2 3 4 5 |
a2dismod php7.3 a2enmod php7.4 apache2ctl configtest systemctl restart apache2 update-alternatives --set php /usr/bin/php7.4 |
如果原来使用 PHP 7.0,则对应执行 a2dismod php7.0。
PHP-FPM 环境不能直接套用上述切换命令。
6.5 验证
|
1 2 |
systemctl status apache2 --no-pager apache2ctl -M | grep -E 'php|mpm' |
网站 phpinfo() 应确认:
|
1 2 3 |
PHP Version = 7.4.33 Server API = Apache 2.0 Handler Loaded Configuration File = /etc/php/7.4/apache2/php.ini |
验证后删除临时测试页面。
七、安装完成后的检查
|
1 2 3 4 |
php7.4 -v php7.4 -m dpkg --audit apt check |
检查软件包:
|
1 |
dpkg -l | grep php7.4 |
检查 Imagick:
|
1 2 |
php7.4 -m | grep -i imagick php7.4 --ri imagick |
如果 Imagick 已正确安装,第二条命令应显示扩展详细信息及对应的 ImageMagick 版本。
比较 PHP 7.3 与 PHP 7.4 扩展:
|
1 2 3 |
php7.3 -m | grep -vE '^\[|^$' | sort -u > /tmp/php73-modules.txt php7.4 -m | grep -vE '^\[|^$' | sort -u > /tmp/php74-modules.txt comm -23 /tmp/php73-modules.txt /tmp/php74-modules.txt |
检查默认版本:
|
1 2 |
php -v update-alternatives --config php |
注意 CLI 和 Apache 实际运行版本可能不同。
八、CVE 漏洞修复验证
8.1 涉及漏洞
- CVE-2026-109618
- CVE-2026-109619
本次使用的第三方 PHP 7.4.33 revision 31 源码声明包含两个 CVE 的安全回移补丁。
修复涉及禁用内部 session upload-progress tracking,普通文件上传功能仍可使用。
8.2 检查构建日志
本次构建日志发现:
|
1 2 |
dpkg-source: info: applying 0164-Avoid-state-corruption-via-bailout.patch |
检查命令:
|
1 2 3 |
grep -nE \ '0164-Avoid-state-corruption|FAILED|Hunk.*FAILED|dpkg-buildpackage' \ build.log |
构建信息:
|
1 2 3 4 |
source package php7.4 source version 1:7.4.33-31+php7.2~debian10.1 source distribution buster host architecture amd64 |
8.3 检查安装版本
|
1 2 3 4 |
dpkg-query -W -f='${Package} ${Version}\n' \ php7.4-common \ php7.4-cli \ libapache2-mod-php7.4 |
九、常见问题及处理
9.1 Sury 软件源 404
|
1 2 |
https://packages.sury.org/php buster Release 404 Not Found |
原因:Sury 公共仓库已不提供 Debian 10 buster 目录。
查找软件源:
|
1 2 3 |
grep -Rn 'packages.sury.org/php' \ /etc/apt/sources.list \ /etc/apt/sources.list.d/ |
停用失效源,不要直接改为 Debian 11 的 bullseye 源。
9.2 APT 提示 _apt 权限不足
|
1 2 |
文件无法被用户 '_apt' 访问 已脱离沙盒并提权为根用户来进行下载 |
通常因为 .deb 位于 /home/php/php74/,属于非致命提示。
9.3 安装后 PHP 默认版本变化
|
1 |
update-alternatives --config php |
选择原 PHP 版本或 PHP 7.4。
9.4 安装 Apache PHP 7.4 后仍使用 PHP 7.3
|
1 2 3 4 |
a2dismod php7.4 a2enmod php7.3 apache2ctl configtest systemctl restart apache2 |
切换前确认 PHP 配置及 Apache 运行模式。
9.5 PHP 7.4 缺少 Imagick
检查:
|
1 |
php7.4 -m | grep -i imagick |
如果没有输出,说明当前 CLI 未加载 Imagick。
不要直接使用旧 PHP 7.0/7.3 的 Imagick .so。
应寻找适配 Debian 9/10 系统库、PHP 7.4 API 20190902 的 Imagick 安装包,并通过 APT 安装后检查模块及业务功能。
9.6 SHA256 校验失败
|
1 |
sha256sum -c SHA256SUMS |
如出现 FAILED,停止安装,核实来源并重新下载。
9.7 缺少 libonig5(Debian10)
服务器实际报错:
|
1 2 |
无法下载 libonig5_6.9.1-1_amd64.deb 暂时不能解析域名 archive.debian.org |
首先尝试 APT 安装:
|
1 2 3 4 5 6 |
apt update apt-cache policy libonig5 apt -s install libonig5 # 模拟无异常后 apt install libonig5 |
如果客户服务器不能访问外网,在另一台机器下载:
|
1 |
http://archive.debian.org/debian/pool/main/libo/libonig/libonig5_6.9.1-1_amd64.deb |
上传至服务器后:
|
1 2 3 4 |
apt -s install ./libonig5_6.9.1-1_amd64.deb # 模拟无异常后 apt install ./libonig5_6.9.1-1_amd64.deb |
随后重新安装 PHP 7.4。
Debian 9 的依赖版本必须单独检查。
9.8 缺少 libsodium23(Debian10)
服务器实际报错:
|
1 2 3 |
php7.4-cli : 依赖: libsodium23 (>= 1.0.14) 但无法安装它 E: 无法修正错误,因为您要求某些软件包保持现状, 就是它们破坏了软件包间的依赖关系。 |
原因:PHP 本地安装包已被 APT 识别,但当前环境无法满足 libsodium23 依赖。服务器无外网、源索引不可用或无候选版本,都可能导致这一结果。
末句“保持现状”是 APT 通用报错,不能仅据此认定软件包被锁定。只有补齐依赖后仍存在冲突,再结合 apt-mark showhold、apt-cache policy 等结果排查。
首先尝试 APT 安装:
|
1 2 3 4 5 6 |
apt update apt-cache policy libsodium23 apt -s install libsodium23 # 模拟无异常后 apt install libsodium23 |
如果客户服务器不能访问外网,在另一台机器下载:
|
1 |
https://archive.debian.org/debian/pool/main/libs/libsodium/libsodium23_1.0.17-1_amd64.deb |
上传至服务器后:
|
1 2 3 4 |
apt -s --no-download install ./libsodium23_1.0.17-1_amd64.deb # 模拟无异常后 apt --no-download install ./libsodium23_1.0.17-1_amd64.deb |
随后重新安装 PHP 7.4。
Debian 9 的依赖版本必须单独检查。
9.9 缺少 libicu63(Debian10)
服务器实际报错:
|
1 2 |
将会同时安装下列软件: libicu63 |
libicu63 是 Debian 10 对应的 ICU 运行库。两者有版本区别,不能简单互换。
APT 安装(推荐)
|
1 2 3 4 5 6 |
apt update apt-cache policy libicu63 apt -s install libicu63 # 模拟无异常后 apt install libicu63 |
如果客户服务器不能访问外网,在另一台机器下载:
|
1 |
https://archive.debian.org/debian/pool/main/i/icu/libicu63_63.1-6%2Bdeb10u3_amd64.deb |
上传至服务器后:
|
1 2 3 4 |
apt -s --no-download install ./libicu63_63.1-6+deb10u3_amd64.deb # 模拟无异常后 apt --no-download install ./libicu63_63.1-6+deb10u3_amd64.deb |
随后重新安装 PHP 7.4。
Debian 9 的依赖版本必须单独检查。
9.10 缺少 libonig4(Debian9)
服务器实际报错:
|
1 2 |
将会同时安装下列软件: libonig4 |
libicu63 是 Debian 9 是 Oniguruma 正则表达式库,主要用于 PHP 的 mbstring 扩展。
APT 安装(推荐)
|
1 2 3 4 5 6 |
apt update apt-cache policy libonig4 apt -s install libonig4 # 模拟无异常后 apt install libonig4 |
如果客户服务器不能访问外网,在另一台机器下载:
|
1 |
https://archive.debian.org/debian-security/pool/updates/main/libo/libonig/libonig4_6.1.3-2%2Bdeb9u2_amd64.deb |
上传至服务器后:
|
1 2 3 4 |
apt -s --no-download install ./libonig4_*.deb # 模拟无异常后 apt --no-download install ./libonig4_*.deb |
随后重新安装 PHP 7.4。
Debian 10 的依赖版本必须单独检查。
9.11 缺少 libsodium18(Debian9)
服务器实际报错:
|
1 2 |
将会同时安装下列软件: libsodium18 |
libsodium18 是 Debian 9 是 Sodium 加密库,用于 PHP 的 Sodium 加密功能。
APT 安装(推荐)
|
1 2 3 4 5 6 |
apt update apt-cache policy libsodium18 apt -s install libsodium18 # 模拟无异常后 apt install libsodium18 |
如果客户服务器不能访问外网,在另一台机器下载:
|
1 |
https://archive.debian.org/debian/pool/main/libs/libsodium/libsodium18_1.0.11-2_amd64.deb |
上传至服务器后:
|
1 2 3 4 |
apt -s --no-download install ./libsodium18_*.deb # 模拟无异常后 apt --no-download install ./libsodium18_*.deb |
随后重新安装 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 环境
|
1 2 3 4 |
cat /etc/os-release dpkg --print-architecture php7.4 -i | grep extension_dir php7.4 -m | grep -i imagick |
PHP 7.4 扩展 API 为 20190902,不能直接使用 PHP 7.0 的 imagick.so。
2. 下载 Imagick DEB 安装包
找到 Debian 10 amd64 对应的 php7.4-imagick 3.7.0-4 安装包。
选择时注意:
- Debian 9/10 选择对应系统版本的 DEB,不能混用。
- ARM 架构选择 arm64 或 armhf,不能使用 amd64。
- Debian 9 和 ARM 的可用历史包尚未确认。
3.上传至服务器检查安装包
|
1 2 3 |
dpkg-deb -f ./php7.4-imagick_*.deb Package Version Architecture Depends dpkg-deb -c ./php7.4-imagick_*.deb | grep imagick.so |
确认扩展目录为 /usr/lib/php/20190902/,且依赖库版本满足要求。
4. 模拟并正式安装
|
1 |
apt -s --no-install-recommends install ./php7.4-imagick_*.deb |
确认没有依赖错误或异常卸载后:
|
1 |
apt --no-install-recommends install ./php7.4-imagick_*.deb |
5. 验证扩展
|
1 2 3 |
phpenmod -v 7.4 imagick php7.4 -m | grep -i imagick php7.4 --ri imagick |
如 Apache 使用 PHP 7.4,在维护窗口执行:
|
1 2 |
apache2ctl configtest systemctl restart apache2 |
注意: 第三方历史镜像软件包需校验来源及哈希;安装前应确认 Debian 版本、CPU 架构、PHP API 和 ImageMagick 依赖均匹配。
十、Apache PHP 版本回滚
如果升级后 LIMS 发生异常,原 PHP 7.3 仍保留时,可以切回:
|
1 2 3 4 |
a2dismod php7.4 a2enmod php7.3 apache2ctl configtest systemctl restart apache2 |
如果原来使用 PHP 7.0,则对应切回 PHP 7.0。
必要时恢复备份的 PHP 与 Apache 配置。