XSS(Cross-Site Scripting)是 Web 前三大漏洞之一,核心成因是「不可信資料未經適當編碼直接輸出至 HTML/JS/CSS 語境」。本文建立分層防禦體系:輸出編碼、HTML 凈化、CSP 標頭、框架內建保護。
根據輸出語境選擇正確編碼函數:
| 輸出語境 | PHP 函數 | 範例 |
|---|---|---|
| HTML 內容/屬性 | htmlspecialchars($str, ENT_QUOTES, 'UTF-8') | <div>= h($user->name) ?></div> |
| HTML 屬性 (單引號) | htmlspecialchars($str, ENT_QUOTES, 'UTF-8') | <input value="= h($val) ?>"> |
| JavaScript 字串 | json_encode($str) (含引號) | <script>const name = = json_encode($name) ?>;</script> |
| URL 參數 | urlencode($str) | <a href="?q== urlencode($q) ?>"> |
| CSS 值 | 專用編碼器 | 避免直接輸出用戶資料到 CSS |
<?php
function h(string $str, int $flags = ENT_QUOTES | ENT_SUBSTITUTE, string $encoding = 'UTF-8'): string {
return htmlspecialchars($str, $flags, $encoding);
}
function hAttr(string $str): string {
return htmlspecialchars($str, ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8');
}
// 使用
echo "{$h($user->bio)}";
echo "";
若需允許用戶輸入富文本(如部落格文章、評論),嚴禁自寫 Regex 過濾,必須使用成熟庫:
composer require ezyang/htmlpurifier
<?php
require_once 'vendor/autoload.php';
$config = HTMLPurifier_Config::createDefault();
$config->set('HTML.Doctype', 'HTML5');
$config->set('HTML.Allowed', 'p,b,i,em,strong,u,br,ul,ol,li,a[href|title],img[src|alt|width|height]');
$config->set('CSS.AllowedProperties', 'color,font-weight,text-align');
$config->set('URI.AllowedSchemes', ['http' => true, 'https' => true, 'mailto' => true]);
$config->set('Cache.SerializerPath', __DIR__ . '/storage/cache/htmlpurifier');
$purifier = new HTMLPurifier($config);
$cleanHtml = $purifier->purify($dirtyHtml);
HTML.Allowed:白名單標籤與屬性,嚴禁 script, iframe, style, on*URI.AllowedSchemes:禁止 javascript:, data:, vbscript:Cache.SerializerPath:啟用快取,效能提升 10-50 倍透過 HTTP 標頭限制瀏覽器載入/執行的資源來源,即使有 XSS 漏洞也能限制傷害:
<?php
// 嚴格 CSP 範例
header("Content-Security-Policy: " . implode('; ', [
"default-src 'self'",
"script-src 'self' 'nonce-" . bin2hex(random_bytes(16)) . "' https://cdn.example.com",
"style-src 'self' 'unsafe-inline' https://fonts.googleapis.com", // unsafe-inline 僅限舊專案過渡
"img-src 'self' data: https:",
"font-src 'self' https://fonts.gstatic.com",
"connect-src 'self' https://api.example.com",
"frame-ancestors 'none'",
"form-action 'self'",
"base-uri 'self'",
"object-src 'none'",
]));
Nonce 實作:每請求生成隨機 nonce,模板中 `