PHP 二次开发:接手旧项目先做哪几件事

接手一个旧 PHP 项目,最怕“先改一个小功能”。旧项目往往缺文档、缺测试、缺备份,改一处会牵出登录、支付、上传或定时任务。正确顺序是先让它可控:能跑、能备份、能回滚、能定位入口,再谈需求。

资讯中心:PHP 二次开发:接手旧项目先做哪几件事

先要齐六样东西

项目 要确认什么 没有时怎么办
代码 完整源码、版本记录、未提交改动 先做只读备份,不在生产直接改
环境 PHP 版本、扩展、Web 服务器、依赖 本地复刻一套可运行环境
数据库 表结构、账号权限、数据量、备份 先导出结构和样本,确认备份可恢复
配置 域名、伪静态、缓存、队列、定时任务 逐项记录,不靠记忆
权限 后台账号、服务器账号、第三方密钥 建立最小权限和交接清单
需求 这次改什么、不改什么、验收标准 写成一页变更说明再报价

少一样,二次开发就会变成“边猜边改”。

第 1 周只做盘点,不急着写功能

1. 让项目跑起来

记录 PHP 版本、扩展、Composer 依赖、数据库连接、缓存和队列。很多旧项目不是代码坏,而是环境不一致:本地 PHP 8.4,线上还是 7.4;本地有扩展,线上没有。

2. 找到入口和路由

先看 index.php、公共入口、配置文件、路由文件、模板目录和数据库访问层。自研 MVC 和框架项目都要先画一张请求链路:

域名 → 入口 → 路由 → 控制器 → 服务/模型 → 模板 → 输出

不知道请求怎么走,改一个页面很容易改到公共逻辑。

3. 看数据库的真实结构

不要只看代码里的字段名。导出表结构,确认:

  • 主键、索引、唯一约束。
  • 软删除、状态字段、时间字段。
  • 哪些表是历史遗留,哪些还在写入。
  • 是否有触发器、视图、定时任务直接改数据。

4. 做一次可恢复备份

代码、数据库、上传目录、配置文件、证书和定时任务都要备份。备份不是复制一份文件,而是确认能在测试环境恢复。没有恢复演练,备份只是一份心理安慰。

5. 先查明显风险

旧项目常见风险:

  • 拼接 SQL、后台弱口令、上传没有类型限制。
  • 错误页暴露路径、密钥写在代码里。
  • 后台没有权限分级,离职账号还能登录。
  • 日志缺失,出问题只能猜。

这些不一定这次都修,但要在报价前说明:哪些是本次范围,哪些是单独的安全整改。

再谈改动边界

把需求分成三类:

  1. 修 bug:现有功能不符合预期,先复现、再定位、再修。
  2. 改现有流程:涉及页面、接口、数据库和权限,必须写清影响范围。
  3. 加新模块:按新功能评估,不要用“顺手加一下”报价。

二次开发报价通常取决于:

  • 旧代码可读性和耦合程度。
  • 是否需要兼容历史数据。
  • 是否涉及支付、登录、权限、文件存储。
  • 是否需要迁移服务器或改域名。
  • 是否需要补测试和文档。

交付时至少要给什么

  • 可运行的代码和部署说明。
  • 数据库变更脚本与回滚方案。
  • 新增配置项和第三方账号清单。
  • 测试账号、测试步骤和已知限制。
  • 本次改动的文件清单。

“改到满意为止”不是验收标准。验收标准应该是可复现的功能点、边界条件和回归范围。

什么情况下不建议接

  • 没有源码,只能改编译产物。
  • 没有数据库备份,也不允许先备份。
  • 生产环境没有测试环境,要求直接在线改。
  • 需求方无法确认验收人,也没有变更边界。
  • 项目涉及明确授权问题的第三方系统或数据。

这些情况下,先做接管和风险整改,比直接接功能更稳妥。

一句话判断

PHP 二次开发的第一步不是写代码,而是把旧项目变成“可运行、可备份、可回滚、可定位”的状态。这个基础没打好,后面每加一个功能都在放大风险。

相关阅读: