蓝绿部署是PHP生产环境零停机更新的可靠方案，通过蓝绿双环境隔离、流量切换、数据库兼容保障及状态资源隔离五大步骤实现无缝升级。
如果您正在运行一个PHP生产服务，但希望在不中断用户请求的前提下更新代码，则蓝绿部署是一种经过验证的架构方案。该方案依赖两套隔离、可互换的运行环境，通过流量导向控制实现新旧版本的瞬时切换。以下是具体实施路径：
一、基于反向代理的双环境流量切换
该方法利用Nginx或HAProxy作为前置负载均衡器，将请求路由至当前活跃环境（如蓝）或待发布环境（如绿），所有文件变更均在离线环境中完成，避免线上目录写入引发的500错误或竞态问题。
1、在服务器上创建两个独立部署路径：/var/www/app-blue 与 /var/www/app-green，确保二者结构完全一致。
2、将CI/CD构建完成的完整代码包（含vendor目录、已优化自动加载器）解压至绿色路径，执行健康检查脚本验证HTTP响应码与关键接口返回。
立即学习“PHP免费学习笔记（深入）”；
3、编辑Nginx主配置文件，在upstream块中定义两个server组，分别指向blue和green的PHP-FPM监听地址或Unix socket路径。
4、修改location块中的proxy_pass指令，将其指向绿色upstream名称，随后执行 nginx -s reload 热重载配置。
5、确认访问日志与监控指标显示流量已全部进入绿色环境，且无5xx错误率上升。
二、符号链接原子化切换法
此方式不依赖外部负载均衡器，而是通过Linux硬链接或软链接机制，在毫秒级内完成web root的指向变更，适用于单机部署或轻量级集群场景，具备强原子性与低运维复杂度。
1、在项目根目录下建立 releases/ 子目录，每次部署生成带时间戳的子目录（如 releases/20260521-1422）。
2、将新版本代码连同完整vendor目录复制进该时间戳目录，并在其中执行 php artisan config:cache 与 php artisan view:cache（Laravel项目）或对应框架缓存重建命令。
3、确保 shared/ 目录存放.env、storage、bootstrap/cache等跨版本共享资源，并在新release目录中建立相应软链接。
4、使用原子命令切换current软链：ln -sf /var/www/app/releases/20260521-1422 /var/www/app/current。
5、重启由supervisord托管的长进程（如队列worker、WebSocket服务），确保其加载的是current路径下的最新代码。
三、容器化蓝绿部署（Docker + Kubernetes）
该方法将PHP应用及其运行时封装为不可变镜像，借助Kubernetes Service的Selector标签与Deployment滚动更新机制，实现环境状态的声明式管理与自动化流量接管，天然支持健康探针与就绪探针校验。
1、编写Dockerfile，以多阶段构建方式在build阶段执行 composer install --no-dev -o，最终镜像仅包含运行时所需文件。
2、为蓝环境Deployment设置标签 env: blue，为绿环境Deployment设置标签 env: green，两者共享同一Service。
3、Service的selector配置为 app: php-web, env in (blue, green)，初始仅blue Pod处于Ready状态。
4、部署新版本时，先应用green Deployment YAML，等待所有Pod通过livenessProbe与readinessProbe检测。
5、更新Service selector，将 env 值由 blue 改为 green，Kubernetes自动终止旧Endpoint并注入新Pod IP。
四、数据库兼容性保障策略
蓝绿部署要求新旧版本代码能同时读写同一套数据库结构，因此数据库迁移必须满足向后兼容原则，禁止破坏性操作，确保蓝环境旧代码在切换期间仍可安全运行。
1、所有字段新增操作必须设置默认值或允许NULL，避免INSERT语句因缺失字段而失败。
2、删除字段或表前，先在新版本代码中移除对该字段的引用，并观察至少一个完整业务周期的日志与监控。
3、使用Laravel的 php artisan migrate --force 在绿色环境部署完成后立即执行迁移，而非在流量切换前执行。
4、对涉及数据逻辑变更的迁移（如状态机调整），采用双写+读取兼容模式：新版本写入新字段，旧版本仍读取旧字段，待全量切换后再清理旧字段。
5、将数据库变更脚本纳入CI流水线，在绿色环境部署包中预置并标记为“仅限绿环境执行”，防止误在蓝环境触发。
五、共享资源与状态隔离设计
PHP应用常依赖外部状态源（如Redis缓存、上传文件存储、日志聚合端点），若未做隔离，蓝绿环境可能因共享键名或路径导致行为冲突，需在部署层明确划分边界。
1、为缓存键名添加环境标识前缀，例如将 user:1001:profile 改为 green:user:1001:profile，并在配置中动态注入ENV变量。
2、上传文件统一接入对象存储（如S3、MinIO），禁用本地public/storage目录直传，消除文件系统耦合。
3、日志输出路径按环境分离，Nginx access_log与error_log均使用 /var/log/nginx/app-green-access.log 类似命名规则。
4、Session存储若使用Redis，应为蓝绿环境分配不同database编号（如db 0为blue，db 1为green），或使用不同key前缀隔离。
5、配置中心（如Consul、etcd）中，各环境对应独立namespace或prefix，确保配置拉取不越界。
