kubernetes 中升级 php 版本必须重建镜像并滚动更新pod,不可热升级;应修改deployment中image标签为新版本(如php:8.2-apache),同步更新扩展与配置路径,并经ci/cd扫描、灰度测试和cronjob验证后上线。
确认当前 PHP 镜像是否真的“可升级”
在 Kubernetes 中,“升级 PHP 版本”不是给运行中的 Pod 执行 apt upgrade php,而是重建容器镜像并滚动更新 Pod。如果你用的是官方 php:7.4-apache 这类基础镜像,它本身不支持热升级;如果你用的是自建镜像(比如基于 Ubuntu + 手动编译 PHP),那更危险——K8s 里改容器内二进制等于白忙,下次调度或重启就回退了。
所以第一件事是查清你用的镜像来源:
- 运行
kubectl get pod -o wide找到对应 Pod,再执行kubectl describe pod <name></name>,看Image:字段是不是类似php:7.4-apache、myapp:v1.2或registry.example.com/php-app:202401 - 如果是带版本号的官方镜像(如
php:7.4-apache),直接换标签就行;如果是自定义镜像,必须重新构建并推送到镜像仓库 - 千万别在 Pod 里执行
docker exec -it xxx /bin/bash然后装新 PHP——这违反不可变基础设施原则,且 K8s 会随时 kill 并重建它
修改 Deployment 中的镜像标签并触发滚动更新
这是最常见也最稳妥的做法:把 image: php:7.4-apache 改成 image: php:8.2-apache,然后让 K8s 自动拉取、创建新 Pod、下线旧 Pod。
实操步骤:
立即学习“PHP免费学习笔记(深入)”;
- 编辑 Deployment:
kubectl edit deploy <your-deploy-name></your-deploy-name> - 找到
spec.template.spec.containers[0].image行,把值改成目标 PHP 镜像,例如:php:8.2-apache或更精确的php:8.2.15-apache-bookworm(推荐带发行版后缀,避免底层系统差异) - 保存退出,K8s 会自动触发滚动更新;也可用命令一键替换:
kubectl set image deploy/<name> php-container=php:8.2-apache</name> - 观察状态:
kubectl rollout status deploy/<name></name>,直到显示successfully rolled out
注意:如果用了 InitContainer、Sidecar 或 ConfigMap 挂载了 php.ini,这些不受影响;但若旧镜像里硬编码了扩展路径(如 extension_dir = "/usr/lib/php/20200930"),新 PHP 8.2 的 SO 文件路径可能是 /usr/lib/php/20220829,会导致 php -m 报错找不到模块——得同步更新 ConfigMap 或在 Dockerfile 里重写