多副本Docker Swarm/Kubernetes集群中PHP OpCache全局刷新方案求助

不建议直接停用OPcache，PHP开启OPcache后性能可提升2~3倍，停用会大幅降低集群服务承载能力，优先选择以下适配方案：

方案1：共享存储集中存储OPcache缓存（Swarm/K8s通用） #

将OPcache的文件缓存路径挂载到所有PHP容器都可访问的共享存储（如NFS、分布式存储卷），所有容器共用同一份缓存文件，清理时只需删除对应缓存文件即可全局生效。

• 核心php.ini配置示例：

; 共享存储上的缓存目录，所有PHP容器都挂载该路径
opcache.file_cache = /mnt/shared/opcache
; 保留内存缓存提升运行性能，文件缓存作为全局同步源
opcache.file_cache_only = 0
; 关闭默认时间戳校验减少IO开销，需清理缓存时手动删除对应缓存文件即可
opcache.validate_timestamps = 0

• 清理逻辑调整：原有flush操作除调用opcache_reset()外，新增删除共享存储中对应站点的缓存文件逻辑，所有容器下次读取时会自动更新本地内存缓存。

方案2：集群内广播触发所有容器执行缓存清理 #

触发flush操作时，调用集群API批量通知所有PHP容器执行本地缓存清理，实现全局缓存同步。

Kubernetes 实现方式 #

• 给PHP Pod配置统一的标识Label（如app: php-fpm），通过K8s API拉取所有匹配Label的Pod IP，给每个Pod的PHP服务发送清理请求。
• 轻量批量清理命令示例：

# 批量给所有匹配label的PHP Pod执行opcache_reset
kubectl get pods -l app=php-fpm -o name | xargs -I {} kubectl exec {} -- php -r 'opcache_reset();'

• 长期方案可在PHP Pod中部署轻量Sidecar，监听ConfigMap变更或消息队列信号，收到清理指令后自动执行本地缓存清理。

Docker Swarm 实现方式 #

• 调用Swarm API拉取PHP服务的所有运行中任务实例，批量发送清理请求。
• 轻量批量清理命令示例：

# 批量给PHP服务的所有运行实例执行opcache_reset
docker service ps -q --filter desired-state=running <你的PHP服务名> | xargs -I {} docker exec {} php -r 'opcache_reset();'

方案3：滚动重启替代全量重启（低侵入过渡方案） #

如果不想修改现有配置与业务逻辑，可使用集群自带的滚动重启功能替代全量重启，业务侧无感知，操作成本极低。

• Kubernetes滚动重启命令：kubectl rollout restart deployment <你的PHP Deployment名>
• Docker Swarm滚动重启命令：docker service update --force <你的PHP服务名>

滚动重启会按预设的最大不可用实例比例逐批重启容器，不会造成服务中断，无需运维人员深度配合。

方案4：镜像构建阶段预生成OPcache缓存 #

将OPcache缓存直接打包到业务Docker镜像中，每次更新代码时同步构建新镜像，发布时通过滚动更新上线，所有新容器启动自带最新缓存，从流程上避免线上清理缓存的需求，适合标准化生产发布流程。

内容的提问来源于stack exchange，提问作者CharlesM