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 二次開發的第一步不是寫程式碼,而是把舊專案變成“可執行、可備份、可復原、可定位”的狀態。這個基礎沒打好,後面每加一個功能都在放大風險。

相關閱讀: