萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

40 個 PHP 開發惡習:從新手錯誤到架構反模式完整檢視

前言:習慣決定代碼品質

PHP 門檻低、上手快,但也因此容易養成壞習慣。以下整理 40 個常見惡習,分為「基礎習慣」、「安全意識」、「架構設計」、「工具流程」四大類,對照自我檢視,逐一改善。

一、基礎習慣類(1-8)

  1. 不寫註解:連函式用途、複雜邏輯意圖都不說明,維護成本極高。
  2. 不使用 IDE:僅用記事本,錯失智能提示、重構、除錯、靜態分析整合。
  3. 不使用版本控制:Git 是基本職業素養,無版控等於無歷史、無協作、無回滾。
  4. 不遵循編碼規範:PSR-12 是社群共識,統一風格降低認知負荷。
  5. 不使用統一命名慣例:變數、函式、類別命名風格混亂,閱讀困難。
  6. 動筆前不思考規劃:直接寫代碼,導致結構混亂、重構困難。
  7. SQL 執行前不驗證與清理:SQL 注入溫床,永遠使用參數化查詢。
  8. 不寫測試、不做 TDD:無測試不敢重構,Bug 只能上線後被使用者發現。

二、開發環境與除錯類(9-12)

  1. 不開啟錯誤回報:error_reporting(E_ALL) 應在開發環境永開,生產環境記錄日誌不顯示。
  2. 不使用除錯工具:var_dump/die 是原始手段,Xdebug 斷點除錯才是專業。
  3. 不重構代碼:重複代碼、巨大函式、神奇數字滿天飛,技術債務滾雪球。
  4. 不採用分層架構(MVC 等):所有邏輯塞在 Controller 或單一檔案,耦合度極高。

三、核心觀念缺失類(13-20)

  1. 不懂 KISS/DRY/MVC/OOP/REST:這些是通用軟體工程術語,不懂等於沒共同語言。
  2. 函式/類別直接 echo/print 輸出:違反單一職責,無法複用、難測試、難快取,應回傳資料。
  3. 不做單元測試:PHPUnit 是標準,沒測試就沒重構信心。
  4. 回傳 HTML 字串而非資料結構:前後端耦合,API 無法複用,前端框架無法接入。
  5. Hardcode 訊息與設定:魔術字串、數字散落代碼,修改需全域搜尋替換。
  6. 不優化 SQL 查詢:N+1 問題、缺索引、Select *、未分析執行計畫。
  7. 不使用自動載入:require_once 滿天飛,Composer PSR-4 是標準。
  8. 不處理錯誤邊界:缺乏例外處理、重試機制、熔斷降級,系統脆弱。

四、安全與架構進階類(21-40)

  1. 用 $_GET 做敏感操作:刪除、修改、付款必須用 POST/PUT/DELETE + CSRF Token。
  2. 不懂正規表示式:驗證、解析、清洗資料的利器,不會用等於少一把刀。
  3. 不知 SQL Injection / XSS:OWASP Top 10 前兩名,務必深入理解原理與防禦。
  4. 不支援彈性配置:建構子注入、Set/Get、常數定義,避免硬編碼。
  5. 不理解 OOP 優缺點:盲目用或盲目不用,都要能說出理由。
  6. 無論大小專案都硬套 OOP:簡單腳本用程序式更清晰,工具服務於問題。
  7. 以為可復用就是 OOP:組合大於繼承,介面隔離、依賴倒置才是核心。
  8. 不使用合理預設值:讓呼叫端最簡單,預設值處理常見情況。
  9. 不集中配置檔:設定散落各處,環境切換痛苦,用 .env + 設定類別。
  10. 用 .inc 隱藏代碼:Web 伺服器不解析 .inc 會直接輸出原始碼,極度危險。
  11. 不使用資料庫抽象層:PDO / Doctrine DBAL / Eloquent 保護免受 SQL 注入、支援多資料庫。
  12. 違反 DRY 原則:複製貼上修改,改一處漏改九處,抽象共用邏輯。
  13. 不開發可複用元件:每次重寫相同功能,建立內部套件庫、Composer 套件。
  14. 不使用抽象類別/介面/多型/封裝:面向介面程式設計是擴充性關鍵。
  15. 不套用設計模式:Factory、Strategy、Repository、Decorator 等解決特定問題。
  16. 不允許使用者自訂基礎路徑:硬編碼路徑,部署環境受限。
  17. 命名空間汙染:用通用詞做前綴(如 array_push),必造成衝突,遵循 PSR-4 命名空間。
  18. 資料表無前綴:共用資料庫時極易衝突,統一加專案前綴如 app_users。
  19. 使用陌生/過時模板引擎:團隊協作選主流(Twig、Blade、Latte),降低學習成本。

改善路徑圖

  1. **建立規範**:專案導入 PHP-CS-Fixer、PHPStan、PHPUnit、Git Hooks。
  2. **重構舊代碼**:優先處理安全風險(SQL 注入、XSS),再處理架構異味。
  3. **學習現代框架**:Laravel / Symfony 強制執行最佳實踐,邊用邊學。
  4. **建立團隊 Wiki**:記錄專案慣例、常見坑點、部署流程,新人上手快。
  5. **定期 Code Review**:互相學習、統一標準、盡早發現問題。

結語

這 40 點不是考卷,而是成長階梯。沒人能一次全做到,但每改掉一項,代碼就更健壯、團隊協作就更順暢。從今天開始,選一項最痛的問題,動手修正它。

copyright © 萬盛學電腦網 all rights reserved