萬盛學電腦網

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

PHP 資料庫存取安全指南:入庫過濾、出庫轉義與輸出情境轉義

資料進出資料庫與輸出到前端是 Web 安全的兩大關鍵環節。舊式 `addslashes`/`stripslashes`/`htmlspecialchars` 混用易導致二次注入、重複編碼、資料損毀。本文建立現代 PHP (PDO/Prepared Statements) 的標準化處理流程。

核心原則:分層防禦

階段操作核心工具關鍵原則
輸入驗證檢查格式、長度、型別、白名單filter_var, Validator 類別拒絕非預期資料
入庫 (SQL)參數化查詢 / 預處理語句PDO::prepare, bindValue資料與代碼分離,徹底防 SQLi
儲存原始資料入庫 (不轉義)--保持資料純淨,避免雙重編碼
出庫/輸出依輸出情境進行情境化轉義htmlspecialchars, json_encode, urlencodeContext-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` 不對稱、輸出順序錯誤。

✅ 現代標準流程 (PDO + 情境化輸出)

1. 入庫:參數化查詢

<?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]);

2. 出庫:直接讀取原始資料

$stmt = $pdo->query('SELECT title, content FROM articles WHERE id = 1');
$article = $stmt->fetch(PDO::FETCH_ASSOC);
// $article['title']、$article['content'] 為原始字串,未經任何轉義

3. 輸出:依情境轉義 (Context-Aware Escaping)

<?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()`

總結

  1. **棄用 `addslashes`/`stripslashes`/`mysql_real_escape_string`**
  2. **入庫:PDO Prepared Statements 參數化查詢**
  3. **儲存:原始資料,不做任何轉義**
  4. **輸出:根據上下文 (HTML/JS/URL/Shell) 選擇正確轉義函式**
  5. **換行轉 `
    `:僅在 HTML 輸出時用 `nl2br(htmlspecialchars(...))`**

建立專案統一的 `e()`, `e_js()`, `e_attr()`, `e_url()` 助手函式並強制 Code Review 使用,能從根本上消除 XSS 與 SQL Injection 風險。

copyright © 萬盛學電腦網 all rights reserved