資料轉義是 Web 安全的第一道防線。本文系統整理 PHP 核心轉義函數:適用場景、編碼規則、常見誤區、現代最佳實務(預處理語句、CSP、HTML Purifier),助你建構安全應用。
| 函數 | 用途 | 轉義字元 | 適用語境 | 反向函數 |
|---|---|---|---|---|
addslashes() | 通用字串轉義 | ' " \ NUL | 舊版 DBMS 無專用函數時 | stripslashes() |
mysqli_real_escape_string() | MySQL 字串轉義 | \x00 \n \r \ ' " \x1a | MySQL 字串字面值(已棄用,改用預處理) | 無(資料庫自動還原) |
htmlspecialchars() | HTML 實體編碼 | & " ' < > | HTML 內容、屬性值(預設雙引號) | htmlspecialchars_decode() |
htmlentities() | 所有 HTML 實體編碼 | 所有可轉義字元 | 需完整實體化輸出 | html_entity_decode() |
strip_tags() | 移除 HTML/PHP 標籤 | 移除標籤、NUL | 簡單過濾、允許特定標籤 | 無 |
escapeshellarg() | Shell 參數轉義 | 單引號包裹、內部單引號轉義 | exec、shell_exec 參數 | 無 |
escapeshellcmd() | Shell 命令轉義 | 特殊字元轉義 | 整個命令字串(較不安全) | 無 |
<?php
// 危險:漏掉轉義、編碼不一、二次注入風險
$name = mysqli_real_escape_string($link, $_POST['name']);
$sql = "SELECT * FROM users WHERE name = '$name'";
<?php
// PDO(推薦)
$pdo = new PDO("mysql:host=localhost;dbname=test;charset=utf8mb4", 'user', 'pass');
$stmt = $pdo->prepare("SELECT * FROM users WHERE name = :name");
$stmt->execute([':name' => $_POST['name']]);
$user = $stmt->fetch();
// mysqli
$stmt = $mysqli->prepare("SELECT * FROM users WHERE name = ?");
$stmt->bind_param('s', $_POST['name']);
$stmt->execute();
$result = $stmt->get_result()->fetch_assoc();
<?php
// 基本用法
echo htmlspecialchars($userInput, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
// 封裝輔助函數
function h(string $str): string {
return htmlspecialchars($str, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}
// 模板中使用
echo "" . h($username) . "";
echo "";
<?php
// 必須使用 ENT_QUOTES 轉義單雙引號
echo ""; // 單引號屬性
echo ''; // 雙引號屬性
// JavaScript 內容輸出(需額外 JS 編碼)
function jsEscape(string $str): string {
return json_encode($str, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP | JSON_UNESCAPED_UNICODE);
}
echo "";
<?php
echo "搜尋";
// 或完整 URL 建構
$url = 'https://example.com/search?' . http_build_query(['q' => $keyword, 'page' => 1]);
當需要允許使用者輸入富文本(如編輯器內容)時,單純 `strip_tags` 不足夠,需使用 HTML Purifier。
<?php
// Composer: require ezyang/htmlpurifier
require_once 'vendor/autoload.php';
$config = HTMLPurifier_Config::createDefault();
$config->set('HTML.Doctype', 'HTML 4.01 Transitional');
$config->set('HTML.Allowed', 'p,b,i,em,strong,u,a[href|title],ul,ol,li,br,img[src|alt|width|height]');
$config->set('CSS.AllowedProperties', 'font-weight,font-style,text-decoration,color,background-color');
$config->set('URI.AllowedSchemes', ['http' => true, 'https' => true, 'mailto' => true]);
$purifier = new HTMLPurifier($config);
$cleanHtml = $purifier->purify($dirtyHtml);
<?php
// ❌ 極度危險
exec("convert $inputImage $outputImage");
// ✅ 正確:escapeshellarg 每個參數單獨轉義
$cmd = 'convert ' . escapeshellarg($inputImage) . ' ' . escapeshellarg($outputImage);
exec($cmd, $output, $returnVar);
// ✅ 更好:proc_open 避免 Shell 解析
$proc = proc_open(['convert', $inputImage, $outputImage], [
0 => ['pipe', 'r'],
1 => ['pipe', 'w'],
2 => ['pipe', 'w'],
], $pipes);
// ✅ 最好:使用 PHP 擴充套件(Imagick、GD)完全避免 Shell
<?php
// PHP 5.4 前 magic_quotes_gpc 自動 addslashes($_GET/POST/COOKIE)
// 已移除,但舊代碼可能殘留雙重轉義檢查
// 相容處理:入口檔案統一清理
if (get_magic_quotes_gpc()) {
function stripslashesDeep($value) {
return is_array($value) ? array_map('stripslashesDeep', $value) : stripslashes($value);
}
$_GET = stripslashesDeep($_GET);
$_POST = stripslashesDeep($_POST);
$_COOKIE = stripslashesDeep($_COOKIE);
}