PHP蓝绿部署通过双环境隔离实现零停机更新：反向代理切换、符号链接原子操作或K8s声明式编排，配合数据库前向兼容、状态外置与版本化缓存，确保平滑过渡。
PHP环境中的蓝绿部署，本质是用两套物理或逻辑隔离的运行环境，把“部署”和“上线”彻底分开。新代码在备用环境完成构建、测试、预热，再通过毫秒级流量切换接管请求，用户完全感知不到更新过程。
反向代理驱动的双环境切换
这是最通用、对现有架构侵入最小的方式，依赖Nginx或HAProxy做流量调度。
- 在服务器上固定两个部署路径，比如
/var/www/app-blue和/var/www/app-green，两者结构、权限、PHP-FPM配置必须一致 - 每次发布时，只向绿色路径部署完整包（含
vendor/、缓存文件、编译后的视图），不碰蓝色路径 - Nginx中定义两个
upstream块，分别指向蓝/绿环境的PHP-FPM监听地址；主location只代理到一个上游名称 - 切换只需改一行配置：把
proxy_pass指向green，执行nginx -s reload，旧连接自然结束，新请求立即进入绿环境
符号链接原子切换（单机友好）
适合中小项目或资源受限场景，不依赖外部负载均衡器，靠Linux文件系统特性保证切换瞬间完成。
- 项目根目录下设
releases/（存各版本）、shared/（存.env、storage、logs等跨版本共享内容） - 新版本解压进
releases/20260523-2010，执行php artisan config:cache等框架初始化命令 - 在新release内为
shared/下的目录建软链，例如ln -sf /var/www/app/shared/storage storage - 执行
ln -sf /var/www/app/releases/20260523-2010 /var/www/app/current，这是一条原子操作，不存在中间态 - 重启supervisor托管的队列worker、WebSocket服务等长进程，确保它们加载
current下的最新代码
数据库与状态资源的兼容处理
蓝绿部署不是只换代码，更要让新旧版本能共存于同一套数据层，否则切换后立刻报错。
立即学习“PHP免费学习笔记（深入）”；
- 数据库迁移必须向前兼容：新增字段加
DEFAULT或允许NULL，删除字段不能立刻执行，等旧版本下线后再清理 - 避免在部署脚本里直接执行
php artisan migrate——它应作为独立步骤，在流量切换前完成，且需验证回滚语句有效 - 上传文件、临时缓存等状态型资源，必须外置到S3、MinIO或共享NAS，不能放在
public/或storage/本地目录 - Redis缓存键名建议带版本前缀，如
v2:user:1001，防止新旧代码读写冲突
容器化环境下的蓝绿实践
当PHP应用已容器化，蓝绿就更接近声明式运维：镜像是不可变的，环境由K8s或Docker Compose编排控制。
- 构建阶段生成带Git SHA或时间戳的镜像标签，如
myapp:20260523-2010，确保可追溯 - K8s中维护两个Deployment（blue/green），Service通过label selector绑定当前活跃环境；切换即修改Service的selector
- 配合Liveness/Readiness探针，确保Pod真正就绪才接收流量，避免切流过早导致502
- Docker Compose方案中，用
docker-compose.override.yml控制端口映射，配合Nginx的upstream动态指向不同容器端口
