萬盛學電腦網

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

PHP 常用轉義與安全函數完整指南:防 SQL 注入、XSS、指令注入

資料轉義是 Web 安全的第一道防線。本文系統整理 PHP 核心轉義函數:適用場景、編碼規則、常見誤區、現代最佳實務(預處理語句、CSP、HTML Purifier),助你建構安全應用。

核心轉義函數對照表

函數用途轉義字元適用語境反向函數
addslashes()通用字串轉義' " \ NUL舊版 DBMS 無專用函數時stripslashes()
mysqli_real_escape_string()MySQL 字串轉義\x00 \n \r \ ' " \x1aMySQL 字串字面值(已棄用,改用預處理)無(資料庫自動還原)
htmlspecialchars()HTML 實體編碼& " ' < >HTML 內容、屬性值(預設雙引號)htmlspecialchars_decode()
htmlentities()所有 HTML 實體編碼所有可轉義字元需完整實體化輸出html_entity_decode()
strip_tags()移除 HTML/PHP 標籤移除標籤、NUL簡單過濾、允許特定標籤無
escapeshellarg()Shell 參數轉義單引號包裹、內部單引號轉義exec、shell_exec 參數無
escapeshellcmd()Shell 命令轉義特殊字元轉義整個命令字串(較不安全)無

防 SQL 注入:現代最佳實務

❌ 錯誤做法:手動轉義拼接 SQL

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

為什麼預處理更安全?

  • 代碼與資料分離:SQL 結構編譯時固定,參數只作為資料傳輸,無法改變查詢邏輯
  • 驅動層處理編碼:自動處理字元集、特殊字元、二進制資料
  • 效能優勢:重複執行同一 SQL 只需解析一次

防 XSS:輸出編碼策略

HTML 內容輸出

<?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 "";

HTML 屬性值輸出

<?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 "";

URL 參數輸出

<?php
echo "搜尋";
// 或完整 URL 建構
$url = 'https://example.com/search?' . http_build_query(['q' => $keyword, 'page' => 1]);

HTML Purifier:完整 HTML 過濾方案

當需要允許使用者輸入富文本(如編輯器內容)時,單純 `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);
}

安全檢查清單

  1. 所有 SQL 使用預處理語句(PDO/mysqli prepare)
  2. 所有 HTML 輸出經過 `htmlspecialchars(..., ENT_QUOTES, 'UTF-8')`
  3. JS 內容輸出用 `json_encode` 配合 HE 標記
  4. Shell 命令用 `escapeshellarg` 逐參數轉義,優先用 PHP 原生擴充
  5. 檔案上傳驗證 MIME、副檔名、內容掃描、儲存於非執行目錄
  6. CSRF 保護:表單 Token、SameSite Cookie
  7. CSP 標頭:`Content-Security-Policy: default-src 'self'; script-src 'self' https://trusted.cdn.com`
  8. 定期掃描:OWASP ZAP、SonarQube、PHPStan 安全規則
copyright © 萬盛學電腦網 all rights reserved