優良的 PHP 代碼不僅能跑通邏輯,更需具備可維護性、安全性與擴展性。本文透過三個層次的程式碼演進,具體展示如何從「能用」走向「優良」。
場景:搜尋頁面顯示用戶輸入的查詢關鍵字。
<?php
// 直接輸出 $_GET,極度危險!
echo "Search results for query: " . $_GET['query'] . ".";
?>
問題:
❌ 直接輸出未過濾輸入 → XSS 漏洞 (攻擊者輸入 )
❌ 無 isset() 判斷 → Notice 錯誤
❌ HTML 與 PHP 混雜,難以維護
<?php
// 使用 htmlspecialchars 防 XSS
echo "Search results for query: " . htmlspecialchars($_GET['query']) . ".";
?>
改進:
✅ 防禦 XSS (預設 ENT_COMPAT 雙引號)
❌ 仍無 isset() 檢查
❌ 邏輯與輸出耦合
<?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) 鋪路
filter_input()、filter_var()、Respect\Validation{{ var }}、Blade {{ $var }})password_hash() + password_verify() (Bcrypt/Argon2)declare(strict_types=1); 每個檔案頂部vlucas/phpdotenv + .env (不進版控)config/{local,staging,production}.php從「能跑」到「優良」,關鍵在於建立標準、工具化檢查、持續重構。以第 3 階段為基準線,配合現代工具鏈 (PHPStan, Psalm, PHPUnit, CS-Fixer, Rector),即可構建安全、可維護、可擴展的 PHP 專案。