资讯中心:PHP 二次开发:接手旧项目先做哪几件事
先要齐六样东西
| 项目 | 要确认什么 | 没有时怎么办 |
|---|---|---|
| 代码 | 完整源码、版本记录、未提交改动 | 先做只读备份,不在生产直接改 |
| 环境 | PHP 版本、扩展、Web 服务器、依赖 | 本地复刻一套可运行环境 |
| 数据库 | 表结构、账号权限、数据量、备份 | 先导出结构和样本,确认备份可恢复 |
| 配置 | 域名、伪静态、缓存、队列、定时任务 | 逐项记录,不靠记忆 |
| 权限 | 后台账号、服务器账号、第三方密钥 | 建立最小权限和交接清单 |
| 需求 | 这次改什么、不改什么、验收标准 | 写成一页变更说明再报价 |
少一样,二次开发就会变成“边猜边改”。
第 1 周只做盘点,不急着写功能
1. 让项目跑起来
记录 PHP 版本、扩展、Composer 依赖、数据库连接、缓存和队列。很多旧项目不是代码坏,而是环境不一致:本地 PHP 8.4,线上还是 7.4;本地有扩展,线上没有。
2. 找到入口和路由
先看 index.php、公共入口、配置文件、路由文件、模板目录和数据库访问层。自研 MVC 和框架项目都要先画一张请求链路:
域名 → 入口 → 路由 → 控制器 → 服务/模型 → 模板 → 输出
不知道请求怎么走,改一个页面很容易改到公共逻辑。
3. 看数据库的真实结构
不要只看代码里的字段名。导出表结构,确认:
- 主键、索引、唯一约束。
- 软删除、状态字段、时间字段。
- 哪些表是历史遗留,哪些还在写入。
- 是否有触发器、视图、定时任务直接改数据。
4. 做一次可恢复备份
代码、数据库、上传目录、配置文件、证书和定时任务都要备份。备份不是复制一份文件,而是确认能在测试环境恢复。没有恢复演练,备份只是一份心理安慰。
5. 先查明显风险
旧项目常见风险:
- 拼接 SQL、后台弱口令、上传没有类型限制。
- 错误页暴露路径、密钥写在代码里。
- 后台没有权限分级,离职账号还能登录。
- 日志缺失,出问题只能猜。
这些不一定这次都修,但要在报价前说明:哪些是本次范围,哪些是单独的安全整改。
再谈改动边界
把需求分成三类:
- 修 bug:现有功能不符合预期,先复现、再定位、再修。
- 改现有流程:涉及页面、接口、数据库和权限,必须写清影响范围。
- 加新模块:按新功能评估,不要用“顺手加一下”报价。
二次开发报价通常取决于:
- 旧代码可读性和耦合程度。
- 是否需要兼容历史数据。
- 是否涉及支付、登录、权限、文件存储。
- 是否需要迁移服务器或改域名。
- 是否需要补测试和文档。
交付时至少要给什么
- 可运行的代码和部署说明。
- 数据库变更脚本与回滚方案。
- 新增配置项和第三方账号清单。
- 测试账号、测试步骤和已知限制。
- 本次改动的文件清单。
“改到满意为止”不是验收标准。验收标准应该是可复现的功能点、边界条件和回归范围。
什么情况下不建议接
- 没有源码,只能改编译产物。
- 没有数据库备份,也不允许先备份。
- 生产环境没有测试环境,要求直接在线改。
- 需求方无法确认验收人,也没有变更边界。
- 项目涉及明确授权问题的第三方系统或数据。
这些情况下,先做接管和风险整改,比直接接功能更稳妥。
一句话判断
PHP 二次开发的第一步不是写代码,而是把旧项目变成“可运行、可备份、可回滚、可定位”的状态。这个基础没打好,后面每加一个功能都在放大风险。
相关阅读: