健康检查需先验证PHP版本与扩展是否符合预期，再调用接口；应在Dockerfile中记录php -v和php -m输出，供健康脚本比对，并在/health端点开头用version_compare校验版本。
PHP版本兼容性问题常在容器启动后才暴露——比如新写的match表达式在PHP 8.0+可用，却部署到了7.4镜像；或扩展如psr未启用导致/health端点直接500报错。健康检查不是“加个curl就行”，而是要让检查逻辑本身适配对应PHP版本的行为与能力，才能真实反映就绪状态。
先确认PHP版本与扩展是否加载成功
健康检查的第一步不是调接口，而是验证运行环境本身是否符合预期。很多就绪失败，根源是镜像声明的PHP版本和实际执行不一致，或关键扩展缺失。
- 在
Dockerfile中用php -v和php -m输出写入临时文件，供健康检查脚本读取比对 - 检查端点（如
/health）开头强制校验：if (version_compare(PHP_VERSION, '8.1', ' - 对扩展做存在性+功能性双检：不仅
extension_loaded('redis')，还要(new Redis())->ping()，避免仅加载未启用
为不同PHP版本设计分层健康检查逻辑
PHP 7.4、8.0、8.2在语法、错误处理、JSON默认行为上差异明显。硬写一个通用检查脚本容易在某个版本崩溃，应按版本分支处理。
- 用
php -r "echo PHP_MAJOR_VERSION.PHP_MINOR_VERSION;"动态获取主次版本号，再include对应版本的检查模块（如health-74.php、health-81.php） - PHP 8.0+支持
str_starts_with()，旧版本需回退到strpos() === 0；健康检查中若用错，会直接500中断，导致Docker标记为unhealthy - 对
json_encode()结果做容错：PHP 8.2默认返回false而非空字符串，检查逻辑需统一用is_string($json) && !empty($json)
在Docker Compose中绑定版本感知的健康检查
同一套docker-compose.yml可能拉起多个PHP版本服务（如API用8.2，报表服务用7.4），不能共用一个test命令。必须按服务粒度配置，且命令需能穿透版本差异。
立即学习“PHP免费学习笔记（深入）”；
- 对PHP-FPM服务，优先用
php-fpm-healthcheck工具（serversideup/php提供），它自动适配FPM状态端点格式，不依赖PHP版本 - 对内置服务器（
php -S），改用curl -f http://localhost:8000/health?phpver=$(php -r 'echo PHP_VERSION;')，让后端根据参数动态启用对应校验路径 - 设置
start_period时考虑版本启动差异：PHP 8.2 JIT预热更久，设90s；PHP 7.4无JIT，45s足够
用健康状态反推版本兼容性问题
当某PHP容器反复进入unhealthy状态但日志无报错，很可能是版本隐性不兼容。此时健康检查本身可成为诊断入口。
- 在
/health响应体中主动返回{"php":"8.1.27","extensions":["pdo","mysqlnd","opcache"],"errors":[]}，便于运维快速定位缺失扩展 - 健康检查失败时，将
error_get_last()或get_cfg_var('error_reporting')写入/tmp/health-last-error.log，供docker exec即时查看 - 配合
docker events --filter 'event=health_status'监听状态变更，结合php -i | grep 'Loaded Configuration File'确认是否加载了预期php.ini
