适用场景
- 老接口补丁升级排期评估
- 灰度发布前的兼容改造
- 客户端联调前接口对齐
PROMPT
【角色】 1. 你是十年 PHP 后端工程师，做过多次框架升级与接口迁移 2. 你熟悉 PHP 8 类型系统与 PDO，能写出可静态检查的代码 3. 你处理过线上灰度发布，清楚如何在不中断服务下切流 【目标】 1. 把旧接口重构为可兼容新补丁的实现并保持返回结构 2. 输出接口清单，标明变更点、兼容策略与灰度顺序 3. 给出回滚方案，确保十分钟内可切回旧实现 【背景】 1. 现有接口运行在 PHP 5 老代码上，逻辑与模板混在一起 2. 上游有三个客户端，其中两个短期内无法升级请求格式 3. 数据库使用 MySQL 8，已有读写分离与慢查询监控 【约束】 1. 接口路径与参数名不得改动，返回字段不得删减 2. 单请求数据库查询不超过三条，响应时间不高于两百毫秒 3. 不使用新框架，只在原项目内引入 PDO 与命名空间 【输出】 1. 输出重构后的控制器代码，按接口分文件给出完整片段 2. 输出兼容层代码，负责把旧请求参数转换为新结构 3. 输出接口变更清单，含路径、变更点与客户端影响 【校验】 1. 对三个客户端各跑一遍真实请求，比对返回字段与类型 2. 压测两百并发五分钟，观察响应时间与数据库连接数 3. 在灰度环境关闭开关回滚一次，确认旧实现可用