資訊中心:PHP 二次開發:接手舊專案先做哪幾件事
先要齊六樣東西
| 專案 | 要確認什麼 | 沒有時怎麼辦 |
|---|---|---|
| 程式碼 | 完整源碼、版本記錄、未送出改動 | 先做只讀備份,不在生產直接改 |
| 環境 | PHP 版本、擴展、Web 伺服器、依賴 | 本地復刻一套可執行環境 |
| 資料庫 | 表結構、帳號權限、資料量、備份 | 先匯出結構和樣本,確認備份可恢復 |
| 設定 | 網域、僞靜態、快取、佇列、排程工作 | 逐項記錄,不靠記憶 |
| 權限 | 後台帳號、伺服器帳號、第三方金鑰 | 建立最小權限和交接清單 |
| 需求 | 這次改什麼、不改什麼、驗收標準 | 寫成一頁變更說明再報價 |
少一樣,二次開發就會變成“邊猜邊改”。
第 1 周只做盤點,不急着寫功能
1. 讓專案跑起來
記錄 PHP 版本、擴展、Composer 依賴、資料庫連接、快取和佇列。很多舊專案不是程式碼壞,而是環境不一致:本地 PHP 8.4,線上還是 7.4;本地有擴展,線上沒有。
2. 找到入口和路由
先看 index.php、公共入口、設定檔案、路由檔案、範本目錄和資料庫訪問層。自研 MVC 和框架專案都要先畫一張請求鏈路:
網域 → 入口 → 路由 → 控制器 → 服務/模型 → 範本 → 輸出
不知道請求怎麼走,改一個頁面很容易改到公共邏輯。
3. 看資料庫的真實結構
不要只看程式碼裡的欄位名。匯出表結構,確認:
- 主鍵、索引、唯一約束。
- 軟刪除、狀態欄位、時間欄位。
- 哪些表是歷史遺留,哪些還在寫入。
- 是否有觸發器、視圖、排程工作直接改資料。
4. 做一次可恢復備份
程式碼、資料庫、上傳目錄、設定檔案、證書和排程工作都要備份。備份不是複製一份檔案,而是確認能在測試環境恢復。沒有恢復演練,備份只是一份心理安慰。
5. 先查明顯風險
舊專案常見風險:
- 拼接 SQL、後台弱口令、上傳沒有類型限制。
- 錯誤頁暴露路徑、金鑰寫在程式碼裡。
- 後台沒有權限分級,離職帳號還能登入。
- 日誌缺失,出問題只能猜。
這些不一定這次都修,但要在報價前說明:哪些是本次範圍,哪些是單獨的安全整改。
再談改動邊界
把需求分成三類:
- 修 bug:現有功能不符合預期,先復現、再定位、再修。
- 改現有流程:涉及頁面、介面、資料庫和權限,必須寫清影響範圍。
- 加新模塊:按新功能評估,不要用“順手加一下”報價。
二次開發報價通常取決於:
- 舊程式碼可讀性和耦合程度。
- 是否需要相容歷史資料。
- 是否涉及支付、登入、權限、檔案儲存。
- 是否需要移轉伺服器或改網域。
- 是否需要補測試和文件。
交付時至少要給什麼
- 可執行的程式碼和部署說明。
- 資料庫變更指令碼與復原方案。
- 新增設定項和第三方帳號清單。
- 測試帳號、測試步驟和已知限制。
- 本次改動的檔案清單。
“改到滿意爲止”不是驗收標準。驗收標準應該是可復現的功能點、邊界條件和回歸範圍。
什麼情況下不建議接
- 沒有源碼,只能改編譯產物。
- 沒有資料庫備份,也不允許先備份。
- 生產環境沒有測試環境,要求直接線上改。
- 需求方無法確認驗收人,也沒有變更邊界。
- 專案涉及明確授權問題的第三方系統或資料。
這些情況下,先做接管和風險整改,比直接接功能更穩妥。
一句話判斷
PHP 二次開發的第一步不是寫程式碼,而是把舊專案變成“可執行、可備份、可復原、可定位”的狀態。這個基礎沒打好,後面每加一個功能都在放大風險。
相關閱讀: