Debian 11/12/13 PHP 7.4 安装升级及漏洞修复维护文档
适用系统: 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
|
1 2 3 |
cat /etc/os-release php -v php -m |
查看已安装的 PHP 软件包:
|
1 |
dpkg -l | grep -E 'php|libapache2-mod-php' |
检查是否已经安装 PHP 7.4:
|
1 |
dpkg -l | grep -E 'php7.4|libapache2-mod-php7.4' |
查看当前 Apache PHP 模块:
|
1 2 |
apache2ctl -M | grep -E 'php|mpm|proxy_fcgi' ls -l /etc/apache2/mods-enabled/*php* 2>/dev/null |
检查 PHP-FPM:
|
1 |
systemctl list-units --all 'php*-fpm.service' |
2.2 备份相关配置
|
1 2 3 4 |
mkdir -p /root/php74-backup cp -a /etc/php /root/php74-backup/ cp -a /etc/apache2 /root/php74-backup/ |
如未安装 Apache,跳过 Apache 备份。
保存原有扩展清单:
|
1 |
php -m > /root/php74-backup/php-modules.txt |
生产服务器还应确认 LIMS 程序、数据库已有可恢复的备份。
三、配置 PHP APT 软件源
3.1 安装基础依赖
|
1 2 |
apt update apt install apt-transport-https ca-certificates curl gnupg lsb-release |
如果系统已有这些工具,可以跳过。
3.2 安装 Sury 签名密钥
方式一
|
1 |
wget -O /etc/apt/trusted.gpg.d/php.gpg https://packages.sury.org/php/apt.gpg |
方式2
|
1 |
curl https://packages.sury.org/php/apt.gpg | apt-key add - |
方式3
下载 Sury 官方密钥包:
|
1 |
curl -fL https://packages.sury.org/debsuryorg-archive-keyring.deb -o /tmp/debsuryorg-archive-keyring.deb |
安装:
|
1 |
dpkg -i /tmp/debsuryorg-archive-keyring.deb |
查看密钥:
|
1 |
gpg --show-keys /usr/share/keyrings/debsuryorg-archive-keyring.gpg |
3.3 配置 PHP 软件源
先检查是否存在旧的 Sury 源配置:
|
1 |
grep -Rn 'packages.sury.org/php' /etc/apt/sources.list /etc/apt/sources.list.d/ |
如果存在重复配置,先备份并禁用多余条目。
创建软件源文件:
|
1 2 3 4 5 |
echo "deb https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list # 或者 cat > /etc/apt/sources.list.d/php.list <<EOF deb [signed-by=/usr/share/keyrings/debsuryorg-archive-keyring.gpg] https://packages.sury.org/php/ $(. /etc/os-release && echo "$VERSION_CODENAME") main EOF |
该配置自动识别 Debian 11/12/13 对应代号。
如果原来已配置 Sury 源,需要停用重复条目,避免签名配置冲突。
3.4 更新软件包索引
|
1 |
apt update |
检查 PHP 7.4 候选版本:
|
1 |
apt-cache policy php7.4-cli php7.4-common libapache2-mod-php7.4 |
目标版本应包含:
|
1 |
1:7.4.33-31+0~20261021... |
并与当前 Debian 版本对应:
|
1 2 3 |
debian11 debian12 debian13 |
Debian 11、12、13 对应的软件包后缀不同,应以各服务器实际显示的版本为准。
如没有符合要求的候选版本,不要继续安装或升级。
四、情况一:首次安装 PHP 7.4
适用于尚未安装 PHP 7.4 的服务器。
4.1 模拟安装
|
1 |
apt -s --no-install-recommends install php7.4 php7.4-cli php7.4-common php7.4-json php7.4-mysql php7.4-curl php7.4-gd php7.4-mbstring php7.4-xml php7.4-zip php7.4-bcmath php7.4-opcache php7.4-readline php7.4-intl php7.4-soap php7.4-imagick |
确认不会卸载原有 PHP、引入无关 PHP 版本或产生依赖冲突。
4.2 正式安装
|
1 |
apt --no-install-recommends install php7.4 php7.4-cli php7.4-common php7.4-json php7.4-mysql php7.4-curl php7.4-gd php7.4-mbstring php7.4-xml php7.4-zip php7.4-bcmath php7.4-opcache php7.4-readline php7.4-intl php7.4-soap php7.4-imagick |
验证:
|
1 2 |
php7.4 -v php7.4 -m |
4.3 安装 Web 运行组件
如果网站使用 Apache mod_php:
|
1 |
apt -s install libapache2-mod-php7.4 |
模拟无异常后:
|
1 |
apt install libapache2-mod-php7.4 |
如果网站使用 PHP-FPM:
|
1 |
apt -s install php7.4-fpm |
模拟无异常后:
|
1 |
apt install php7.4-fpm |
两种方式按照实际部署选择,不需要全部安装。
五、情况二:升级已经安装的 PHP 7.4
适用于服务器已经安装 PHP 7.4,仅需要更新到安全修订版的情况。
5.1 获取已安装软件包
|
1 2 3 4 5 6 |
PKGS=$(dpkg-query -W \ -f='${db:Status-Abbrev} ${binary:Package}\n' \ 'php7.4-*' 'libapache2-mod-php7.4' 2>/dev/null \ | awk '$1=="ii" && $2 !~ /imagick/ {print $2}') printf '%s\n' "$PKGS" |
上述命令自动获取已安装的 PHP 7.4 软件包,暂时排除 Imagick,以避免在部分环境中引入 PHP 8.5 等无关软件包。
5.2 模拟升级
|
1 |
apt -s --no-install-recommends install --only-upgrade $PKGS |
检查是否存在意外卸载、新增 PHP 8.x 或升级无关系统组件的情况。
5.3 正式升级
在维护窗口执行:
|
1 |
apt --no-install-recommends install --only-upgrade $PKGS |
该命令仅对已安装的软件包进行升级,不会主动安装不存在的扩展。
如果有额外安装的 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 扩展
先检查:
|
1 |
php7.4 -m | grep -i imagick |
如果没有安装,先模拟:
|
1 |
apt -s --no-install-recommends install php7.4-imagick |
确认没有额外引入无关 PHP 版本后:
|
1 |
apt --no-install-recommends install php7.4-imagick |
如果 Imagick 已安装,只需升级:
|
1 |
apt -s --no-install-recommends install --only-upgrade php7.4-imagick |
模拟正常后去掉 -s 正式执行。
|
1 |
apt --no-install-recommends install --only-upgrade php7.4-imagick |
检查:
|
1 |
php7.4 --ri imagick |
其他第三方扩展(如 Redis、Smbclient、DS 等)按照实际业务需要单独安装。
6.3 比较新旧 PHP 扩展
例如原来使用 PHP 7.0:
|
1 2 3 |
comm -23 \ <(php7.0 -m | grep -vE '^\[|^$' | sort -u) \ <(php7.4 -m | grep -vE '^\[|^$' | sort -u) |
输出内容为 PHP 7.0 存在、PHP 7.4 当前 CLI 没有加载的扩展。
注意:如果网站使用 Apache mod_php 或 FPM,还需要验证相应运行环境加载的扩展。
七、配置迁移及运行版本切换
7.1 PHP 配置文件位置
|
1 2 3 4 |
/etc/php/7.4/cli/php.ini /etc/php/7.4/apache2/php.ini /etc/php/7.4/fpm/php.ini /etc/php/7.4/mods-available/ |
根据实际运行方式使用对应配置文件。
例如原来使用 PHP 7.3 Apache:
|
1 2 3 |
diff -u \ /etc/php/7.3/apache2/php.ini \ /etc/php/7.4/apache2/php.ini |
重点迁移:
|
1 2 3 4 5 6 7 |
memory_limit max_execution_time max_input_vars upload_max_filesize post_max_size date.timezone 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 |
7.2 切换 Apache PHP 模块
如果网站使用 Apache mod_php,原来启用 PHP 7.3:
|
1 2 3 4 |
a2dismod php7.3 a2enmod php7.4 apache2ctl configtest systemctl restart apache2 |
如果原来启用 PHP 7.0,则将禁用命令改为:
|
1 |
a2dismod php7.0 |
7.3 PHP-FPM 切换
如果网站通过 PHP-FPM 运行,应检查:
|
1 |
systemctl status php7.4-fpm |
确认 PHP 7.4 FPM 监听的 Socket 或端口:
|
1 |
grep -E '^listen\s*=' /etc/php/7.4/fpm/pool.d/*.conf |
根据实际情况调整 Apache 或 Nginx 网站配置,使其指向 PHP 7.4 FPM。
完成配置检查后,再重启或重载对应服务。
7.4 切换默认 CLI
|
1 |
update-alternatives --set php /usr/bin/php7.4 |
验证:
|
1 |
php -v |
注意:CLI PHP 与 Apache/FPM 的 PHP 版本相互独立。
八、升级完成后的验证
8.1 PHP 版本及扩展
|
1 2 |
php7.4 -v php7.4 -m |
查看已安装软件包版本:
|
1 2 |
dpkg-query -W -f='${Package} ${Version}\n' \ php7.4-cli php7.4-common |
如果安装了 Apache PHP 模块:
|
1 |
dpkg-query -W libapache2-mod-php7.4 |
确认修订版本为 7.4.33-31 或经验证包含相应安全补丁的后续修订版。
8.2 软件包状态
|
1 2 |
dpkg --audit apt-get check |
正常情况下没有依赖错误和配置异常。
8.3 Apache/PHP-FPM 状态
Apache:
|
1 2 |
apache2ctl configtest systemctl status apache2 --no-pager |
PHP-FPM:
|
1 |
systemctl status php7.4-fpm --no-pager |
如果对应服务没有安装,可跳过。
8.4 网站 PHP 版本
通过临时 phpinfo() 页面确认:
|
1 2 3 |
PHP Version: 7.4.33 Server API: Apache 2.0 Handler 或 FPM/FastCGI Loaded Configuration File: PHP 7.4 对应 php.ini |
验证后立即删除临时页面。
九、回滚及业务验收
9.1 Apache 版本回滚
如果从 PHP 7.3 切换到 7.4 后出现业务异常:
|
1 2 3 4 5 |
a2dismod php7.4 a2enmod php7.3 apache2ctl configtest systemctl restart apache2 |
原来使用 PHP 7.0 的服务器,则恢复对应 PHP 7.0 模块。
9.2 CLI 回滚
|
1 |
update-alternatives --set php /usr/bin/php7.3 |
根据原有版本调整。
对于 PHP-FPM,应恢复原有的 Web 服务器转发配置,并重新加载对应服务。
注意:如果原来已经使用 PHP 7.4,仅升级了 PHP 7.4 软件包,回退到旧修订版需要事先保存的旧版软件包,不能通过切换 Apache 模块完成。
十、常见问题及处理
10.1 Sury GPG 密钥过期
错误:
|
1 2 |
EXPKEYSIG B188E2B695BD4743 DEB.SURY.ORG Automatic Signing Key |
原因: APT 使用的仓库签名密钥过期、未正确更新,或实际加载了其他旧密钥。
处理:
优先按照第三节重新安装 Sury 官方 keyring 并配置 signed-by。
如果旧源仍然出现签名问题,可重新下载有效密钥:
|
1 2 3 4 5 |
curl -fL \ https://packages.sury.org/php/apt.gpg \ -o /usr/share/keyrings/sury-php.gpg chmod 644 /usr/share/keyrings/sury-php.gpg |
对应软件源:
|
1 |
deb [signed-by=/usr/share/keyrings/sury-php.gpg] https://packages.sury.org/php/ bullseye main |
其中 bullseye 根据操作系统版本更改。
更新:
|
1 2 |
rm -f /var/lib/apt/lists/*packages.sury.org* apt update |
如仍报错,可通过 gpgv 验证仓库签名:
|
1 2 3 4 5 6 7 |
curl -fL \ https://packages.sury.org/php/dists/bullseye/InRelease \ -o /tmp/sury-InRelease gpgv \ --keyring /usr/share/keyrings/sury-php.gpg \ /tmp/sury-InRelease |
Debian 12/13 修改为对应系统代号。
不要使用 trusted=yes 或禁用签名校验来绕过错误。
10.2 APT 软件包下载 404
错误示例:
|
1 |
404 Not Found |
原因: 镜像同步异常、软件包已迁移、APT 索引陈旧或代理缓存问题。
处理:
|
1 2 |
apt clean apt update |
如仍然报错,可检查软件包实际下载地址和候选版本:
|
1 |
apt-cache policy ca-certificates |
必要时更换为可访问且可信的 Debian 软件源,或下载经过校验的对应 .deb 本地安装。
不要使用不存在的包地址反复尝试。
10.3 apt update 成功但 PHP 版本没变化
原因: apt update 仅更新软件包索引,不会升级已安装的 PHP。
检查:
|
1 |
apt-cache policy php7.4-cli |
如果 Installed 为旧版本、Candidate 为新版本,需要执行第五节的升级命令。
10.4 PHP 7.4 已更新,但 php -v 还是旧版本
原因: 多版本 PHP 共存,系统默认 CLI 仍然指向旧版本。
处理:
|
1 2 3 |
update-alternatives --config php # 或者 update-alternatives --set php /usr/bin/php7.4 |
注意该操作只改变 CLI 默认版本,不代表网站 PHP 已切换。
10.5 PHP 7.4 缺少原有扩展
原因: 新旧 PHP 扩展安装范围不同,且第三方二进制扩展通常不兼容不同的 PHP API。
处理:
|
1 |
php7.4 -m |
再与原 PHP 扩展清单比较。
需要补装的扩展通过 APT 选择兼容 PHP 7.4 的软件包,不能直接复制旧版本 .so 文件。
10.6 APT 提示可以 autoremove PHP 相关软件包
例如:
|
1 2 |
php7.4-mysql debsuryorg-archive-keyring |
被标记为自动安装且不再需要。
处理:
升级过程中不要直接执行:
|
1 |
apt autoremove |
确认仍需要的软件包后,可以设置为手动安装:
|
1 |
apt-mark manual php7.4-mysql debsuryorg-archive-keyring |
仅对实际安装且确实需要长期保留的软件包执行。