萬盛學電腦網

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

安全顯示使用者輸入內容:從 htmlspecialchars 到自訂標記語言的完整防護策略

風險:直接輸出未過濾的使用者內容

若直接 echo $userInput,惡意使用者可注入 JavaScript(XSS)、破壞 HTML 結構、竊取 Cookie、發起 CSRF 攻擊。例如:

<script>alert('XSS')</script>
<img src=x onerror=stealCookie()>

層級 1:純文字輸出(最安全、最簡單)

<?php
echo htmlspecialchars($userInput, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
// <  → &lt;   > → &gt;   " → &quot;   ' → '   & → &amp;
?>
  • 適用:評論、留言、搜尋關鍵字、任何不需排版的純文字欄位。
  • 缺點:使用者無法使用任何排版(粗體、連結、列表)。

層級 2:自訂標記語言(BBCode/Markdown 風格)

允許使用者使用受限、安全的標記,伺服端解析轉換為安全 HTML。

簡易 BBCode 解析器範例

<?php
function parseBBCode(string $text): string
{
    // 1. 先全域轉義,徹底中和所有 HTML
    $text = htmlspecialchars($text, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
    
    // 2. 定義允許的標記對應規則(搜尋 → 替換)
    $patterns = [
        // [b]粗體[/b]
        '/\[b\](.*?)\[\/b\]/s'         => '<strong>$1</strong>',
        // [i]斜體[/i]
        '/\[i\](.*?)\[\/i\]/s'         => '<em>$1</em>',
        // [u]底線[/u]
        '/\[u\](.*?)\[\/u\]/s'         => '<u>$1</u>',
        // [url]連結[/url] 或 [url=網址]文字[/url]
        '/\[url\](.*?)\[\/url\]/s'     => '<a href="$1" rel="nofollow ugc">$1</a>',
        '/\[url=(.*?)\](.*?)\[\/url\]/s' => '<a href="$1" rel="nofollow ugc">$2</a>',
        // [img]圖片網址[/img]
        '/\[img\](.*?)\[\/img\]/s'     => '<img src="$1" alt="" loading="lazy">',
        // [code]程式碼[/code]
        '/\[code\](.*?)\[\/code\]/s'   => '<pre><code>$1</code></pre>',
        // 換行
        '/\r?\n/'                      => '<br>',
    ];
    
    foreach ($patterns as $pattern => $replacement) {
        $text = preg_replace($pattern, $replacement, $text);
    }
    
    return $text;
}
?>

進階:使用成熟庫(推薦生產環境)

  • HTMLPurifier:業界標準 HTML 白名單過濾器,支援高度客製化允許標籤/屬性/樣式,完美防禦 XSS。
  • Parsedown / League\CommonMark:Markdown 解析器,內建安全過濾選項。
  • BBCode 解析器:jbbcode/jbbcode 等 Composer 套件。

層級 3:受限 HTML 白名單(需極度謹慎)

若業務必須允許部分 HTML(如富文本編輯器輸出),務必使用 HTMLPurifier,手寫 strip_tags 或 preg_replace 絕對不安全(繞過手法極多:事件屬性、CSS expression、編碼繞過、巢狀標籤...)。

<?php
require_once 'vendor/autoload.php'; // composer require ezyang/htmlpurifier

$config = HTMLPurifier_Config::createDefault();
// 自訂允許標籤
$config->set('HTML.Allowed', 'p,b,i,u,em,strong,a[href|title],ul,ol,li,br,img[src|alt|width|height]');
$config->set('CSS.AllowedProperties', ['font-weight', 'font-style', 'text-decoration']);
$config->set('URI.AllowedSchemes', ['http' => true, 'https' => true, 'mailto' => true]);

$purifier = new HTMLPurifier($config);
$safeHtml = $purifier->purify($userHtmlInput);
?>

輸出情境別建議策略

情境策略關鍵函數/工具
HTML 屬性值htmlspecialchars(..., ENT_QUOTES)htmlspecialchars
URL 參數urlencodeurlencode, http_build_query
JavaScript 字串/JSONjson_encode (自動處理引號、換行、Unicode)json_encode
CSS 值cssesc 或 白名單驗證避免直接輸出使用者輸入至 CSS
SQL 查詢參數化查詢 / 預處理語句PDO::prepare, mysqli_stmt
Shell 命令escapeshellarg / escapeshellcmdescapeshellarg

結語

「輸出時過濾,依情境編碼」是防禦 XSS 的鐵律。現代開發應:

  1. 預設對所有動態輸出使用 htmlspecialchars(模板引擎通常內建自動逃逸)。
  2. 需要排版功能時,引入 Markdown/BBCode + 成熟解析器 或 HTMLPurifier。
  3. 絕不信任 任何來自使用者、第三方 API、資料庫的資料直接輸出到 HTML/JS/CSS/URL/SQL/Shell 語境中。
copyright © 萬盛學電腦網 all rights reserved