資料進出資料庫與輸出到前端是 Web 安全的兩大關鍵環節。舊式 `addslashes`/`stripslashes`/`htmlspecialchars` 混用易導致二次注入、重複編碼、資料損毀。本文建立現代 PHP (PDO/Prepared Statements) 的標準化處理流程。
| 階段 | 操作 | 核心工具 | 關鍵原則 |
|---|---|---|---|
| 輸入驗證 | 檢查格式、長度、型別、白名單 | filter_var, Validator 類別 | 拒絕非預期資料 |
| 入庫 (SQL) | 參數化查詢 / 預處理語句 | PDO::prepare, bindValue | 資料與代碼分離,徹底防 SQLi |
| 儲存 | 原始資料入庫 (不轉義) | -- | 保持資料純淨,避免雙重編碼 |
| 出庫/輸出 | 依輸出情境進行情境化轉義 | htmlspecialchars, json_encode, urlencode | Context-Aware Escaping |
<?php
// 入庫
$str = addslashes($str); // 僅轉義單引號、雙引號、反斜線、NUL
$sql = "INSERT INTO tab (content) VALUES ('$str')"; // 字串拼接 → SQLi 風險
// 出庫
$str = stripslashes($str); // 移除 addslashes 加入的斜線
// 輸出
echo htmlspecialchars(nl2br($str)); // nl2br 在 htmlspecialchars 前 →
被轉義顯示為文字
問題:`addslashes` 不完整 (不處理編碼、多位元組繞過)、字串拼接 SQL 根本不可取、`stripslashes` 與 `addslashes` 不對稱、輸出順序錯誤。
<?php
$pdo = new PDO('mysql:host=localhost;dbname=test;charset=utf8mb4', 'user', 'pass', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_EMULATE_PREPARES => false, // 使用真實預處理
]);
// 輸入驗證 (範例)
$title = filter_input(INPUT_POST, 'title', FILTER_SANITIZE_STRING);
$content = $_POST['content'] ?? ''; // 內容不做 sanitize,保留原始
// 預處理語句
$stmt = $pdo->prepare('INSERT INTO articles (title, content, created_at) VALUES (?, ?, NOW())');
$stmt->execute([$title, $content]); // 參數自動綁定,徹底防 SQLi
// 或命名參數
$stmt = $pdo->prepare('INSERT INTO articles (title, content) VALUES (:title, :content)');
$stmt->execute([':title' => $title, ':content' => $content]);
$stmt = $pdo->query('SELECT title, content FROM articles WHERE id = 1');
$article = $stmt->fetch(PDO::FETCH_ASSOC);
// $article['title']、$article['content'] 為原始字串,未經任何轉義
<?php
// --- HTML 內容區塊 (div, p, span, td 等) ---
<div><?= htmlspecialchars($article['content'], ENT_QUOTES, 'UTF-8') ?></div>
// --- HTML 屬性值 (value, href, title, data-* 等) ---
<input value="<?= htmlspecialchars($title, ENT_QUOTES, 'UTF-8') ?>">
<a href="<?= htmlspecialchars($url, ENT_QUOTES, 'UTF-8') ?>">連結</a>
// --- JavaScript 字串/變數 ---
<script>
var title = <?= json_encode($title, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP) ?>;
var content = <?= json_encode($content, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP) ?>;
</script>
// --- URL 參數 ---
<a href="/search?q=<?= urlencode($keyword) ?>">搜尋</a>
// --- Shell 指令參數 (極少用,慎用) ---
$cmd = 'convert ' . escapeshellarg($inputPath) . ' ' . escapeshellarg($outputPath);
`nl2br` 屬於**顯示層邏輯**,應在**輸出到 HTML 時**才執行,而非入庫前。
<?php
// ✅ 正確:輸出時才轉換換行
echo nl2br(htmlspecialchars($content, ENT_QUOTES, 'UTF-8'));
// ❌ 錯誤:入庫前 nl2br → 資料庫存
標籤 → 輸出時再 htmlspecialchars → 顯示 <br> 文字
// ❌ 錯誤:htmlspecialchars(nl2br($content)) →
被轉義為 <br>
<?php
function e(string $str, int $flags = ENT_QUOTES, string $encoding = 'UTF-8'): string {
return htmlspecialchars($str, $flags, $encoding, true);
}
function e_js(string $str): string {
return json_encode($str, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP);
}
function e_url(string $str): string {
return urlencode($str);
}
function e_attr(string $str): string {
return htmlspecialchars($str, ENT_QUOTES, 'UTF-8');
}
// Blade/Twig 風格使用
// {{ e($content) }} → HTML 內容
// {{ e_attr($title) }} → HTML 屬性
// {{ e_js($data) }} → JS 變數
// {{ e_url($keyword) }} → URL 參數
| 欄位類型 | 入庫處理 | 輸出處理 |
|---|---|---|
| 標題/姓名/標籤 (純文字) | trim、長度驗證、禁止控制字元 | `e()` |
| 文章內容/留言 (允許有限 HTML) | 原始儲存 | HTML Purifier 白名單過濾後 `echo` |
| URL/連結 | 驗證格式 (filter_var FILTER_VALIDATE_URL) | 屬性用 `e_attr()`,JS 用 `e_js()` |
| JSON 資料 | 驗證 JSON 格式、存 TEXT/JSON 型別 | JS 用 `e_js()`,HTML 用 `e()` |
| Cookie 值 | 簽名/加密儲存 (不要信任 Client Cookie) | 讀取時驗證簽名,輸出用 `e()` |
建立專案統一的 `e()`, `e_js()`, `e_attr()`, `e_url()` 助手函式並強制 Code Review 使用,能從根本上消除 XSS 與 SQL Injection 風險。