PHP 8.5.7 更新后如何安排扩展兼容性检查

PHP 8.5.7 是 PHP 8.5 分支的 bug fix release。升级后最容易漏掉的不是业务代码，而是“CLI 已经换了、PHP-FPM 还没换”或某个 PECL 扩展仍然绑定旧的运行时。稳妥做法是先建立扩展基线，再按真实调用链做小范围回归，最后灰度放量，而不是看到版本号变化就把所有依赖全部升级。

官方资料：https://www.php.net/releases/8_5_7.php

先确认 8.5.7 改的是哪一层

官方发布说明将 8.5.7 定义为 bug fix release，并建议 PHP 8.5 用户升级；这不等于可以跳过验证。若你的环境是从 8.5.6 升到 8.5.7，主要关注点是补丁带来的运行时行为变化和扩展二进制是否重新匹配；若同时从 8.4 跨到 8.5，则应额外阅读 PHP 8.5 migration guide，因为小版本分支迁移包含不兼容项。

先在目标机器和 FPM 容器中分别执行以下命令。命令里的输出要保存到发布记录，避免只验证了登录终端的 PHP。

# 记录 CLI 版本、SAPI、配置文件和实际加载的扩展
php -v
php --ini
php -m | sort

# 确认 FPM 使用的版本与扩展；按发行版调整服务名
php-fpm8.5 -i | grep -E 'PHP Version|Server API|Loaded Configuration File'
systemctl status php8.5-fpm --no-pager

如果 CLI 显示 8.5.7，而 FPM 仍显示旧版本，先修正服务指向；否则后面的回归结果没有意义。

把扩展兼容性拆成三张清单

扩展检查不要只做“能否加载”。建议把清单拆为必需运行扩展、可选功能扩展和仅开发扩展，并为每项记录来源、版本、是否有业务入口以及失败后的影响。内置扩展通常随 PHP 包一起更新，PECL 或自编译扩展则要确认它是为当前 PHP 8.5 ABI 构建的。

依赖层再运行 composer check-platform-reqs。它能发现平台要求不满足，但不能替代真实接口回归；一个扩展“已加载”也不代表连接池、序列化格式或边界参数行为没有变化。

用真实调用链安排最小回归

回归顺序建议从启动到业务外围逐步扩展：先启动 FPM 并访问健康检查，再验证数据库读写、缓存读写、队列投递与消费、文件上传、图片处理、邮件或加密接口，最后跑定时任务和 CLI 命令。每一项都记录“请求/命令、日志、耗时、结果”四列，出现 warning 也不要只看 HTTP 200。

# 运行项目自己的测试与平台依赖检查；失败时保留完整输出
composer check-platform-reqs
php -d display_errors=1 vendor/bin/phpunit --testsuite=smoke

# 只筛选本次发布相关的错误级别，避免把普通访问日志混在结论里
journalctl -u php8.5-fpm --since "10 minutes ago" --no-pager \
  | grep -E 'WARNING|ERROR|Fatal|未定义|Unable to load'

图像、加密和数据库扩展尤其适合加入一条最小真实样例：上传一张固定尺寸图片、执行一次事务回滚、读写一条 UTF-8 文本，并比较升级前后的输出。这样比只跑一组单元测试更容易发现扩展层差异。

灰度放行前保留回滚条件

先让一台实例或一小部分流量使用 8.5.7，观察 5xx、FPM worker 重启、慢请求、队列积压和扩展加载错误。稳定后再扩大范围。回滚包至少包含旧 PHP 包、旧扩展包、php.ini、FPM 池配置和 Composer lock；不要只准备一个“切回旧镜像”的口头方案。

如果问题只出现在某个扩展，优先固定扩展版本或切换到维护者已声明支持 PHP 8.5 的构建，不要用关闭错误显示来掩盖启动警告。PHP 官方支持页还会持续变化，后续补丁应重新核对分支状态和变更记录。

发布前的四项速查

• CLI 与 FPM/SAPI 的 PHP 版本、配置文件和扩展列表一致。
• Composer 平台检查通过，PECL/自编译扩展有可重建记录。
• 数据库、缓存、队列、文件/图片、加密和 CLI 任务至少各有一条真实回归。
• 灰度指标、旧包位置和明确回滚触发条件已经写入发布单。

常见问题

PHP 8.5.7 是补丁更新，还需要重装所有扩展吗？

不必一律重装，但必须确认扩展来自同一 PHP 运行时并能正常加载。PECL 或自编译扩展应按当前环境重新核对构建产物和符号依赖。

为什么 php -m 正常，网站请求仍然报扩展错误？

CLI 与 FPM 可能使用不同的二进制、php.ini 或服务容器。用 FPM 的信息输出和服务状态单独确认，不能把 CLI 结果当成网站运行时结果。

从 PHP 8.4 升到 8.5 也能用同一套检查吗？

可以复用扩展回归框架，但还要逐项阅读 PHP 8.5 migration guide 的不兼容和弃用章节，并扩大语法、框架和业务测试范围。