萬盛學電腦網

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

PHP 代碼品質四大支柱:安全、結構化、規範化、自適應

PHP 代碼品質四大支柱:安全、結構化、規範化、自適應

優良的 PHP 代碼不僅能跑通邏輯,更需具備可維護性、安全性與擴展性。本文透過三個層次的程式碼演進,具體展示如何從「能用」走向「優良」。

四大核心原則

  1. 安全性:防範 XSS、SQL 注入、CSRF、檔案上傳漏洞等。
  2. 結構化:模組化、關注點分離、遵循 SOLID 原則、使用設計模式。
  3. 規範化:遵循 PSR-1/PSR-12 編碼風格、嚴格型別宣告、統一命名慣例。
  4. 自適應:配置與代碼分離、環境感知、支援多環境部署、向後相容。

演進對比:同一功能的三種寫法

場景:搜尋頁面顯示用戶輸入的查詢關鍵字。

第 1 階段:未優化 (高風險、差結構)

<?php
// 直接輸出 $_GET,極度危險!
echo "Search results for query: " . $_GET['query'] . ".";
?>

問題:
❌ 直接輸出未過濾輸入 → XSS 漏洞 (攻擊者輸入 )
❌ 無 isset() 判斷 → Notice 錯誤
❌ HTML 與 PHP 混雜,難以維護

第 2 階段:簡單優化 (修補 XSS,仍結構鬆散)

<?php
// 使用 htmlspecialchars 防 XSS
echo "Search results for query: " . htmlspecialchars($_GET['query']) . ".";
?>

改進:
✅ 防禦 XSS (預設 ENT_COMPAT 雙引號)
❌ 仍無 isset() 檢查
❌ 邏輯與輸出耦合

第 3 階段:合理優化 (安全、結構、規範兼備)

<?php
// 1. 嚴格檢查輸入存在性
if (isset($_GET['query'])) {
    // 2. 使用 ENT_QUOTES 轉義單雙引號,編碼指定 UTF-8
    $safeQuery = htmlspecialchars($_GET['query'], ENT_QUOTES, 'UTF-8');

    // 3. 邏輯與模板分離 (此處用簡單 echo 示範,實務建議用模板引擎)
    echo 'Search results for query: ' . $safeQuery . '.';
}
?>

亮點:
✅ isset() 防 Notice
✅ ENT_QUOTES 完整轉義屬性內輸出
✅ 明確指定編碼 UTF-8
✅ 變數命名語意化 ($safeQuery)
✅ 為引入模板引擎 (Twig, Blade, Latte) 鋪路

現代 PHP 最佳實踐清單 (2024+)

安全篇

  • 輸入驗證:filter_input()、filter_var()、Respect\Validation
  • 輸出編碼:模板引擎自動逃逸 (Twig {{ var }}、Blade {{ $var }})
  • 資料庫:只用預處理語句 (PDO::prepare / mysqli::prepare)
  • 密碼:password_hash() + password_verify() (Bcrypt/Argon2)
  • CSRF:所有狀態改變請求驗證 Token
  • 檔案上傳:驗證 MIME、副檔名、重命名儲存、禁止執行權限

結構化篇

  • Composer 自動載入 (PSR-4)
  • 依賴注入容器 (PHP-DI, Symfony DI, Laravel Container)
  • Repository / Service / Action / DTO 分層
  • 中介軟體處理横切關注點 (Auth, Log, RateLimit)

規範化篇

  • 強制 declare(strict_types=1); 每個檔案頂部
  • PHPStan / Psalm 靜態分析 (Level 5+)
  • PHP_CodeSniffer (PSR-12) + PHP-CS-Fixer 自動修正
  • PHPUnit / Pest 單元測試覆蓋率 ≥ 80%
  • Git Hooks (Husky/pre-commit) 強制風格檢查

自適應篇

  • 環境變數管理:vlucas/phpdotenv + .env (不進版控)
  • 配置檔分環境:config/{local,staging,production}.php
  • 特性開關 (Feature Flags) 控制新功能灰度釋出
  • 遵循 Twelve-Factor App 原則

總結

從「能跑」到「優良」,關鍵在於建立標準、工具化檢查、持續重構。以第 3 階段為基準線,配合現代工具鏈 (PHPStan, Psalm, PHPUnit, CS-Fixer, Rector),即可構建安全、可維護、可擴展的 PHP 專案。

copyright © 萬盛學電腦網 all rights reserved