在 PHP 後端渲染頁面時,常需將包含 HTML 的字串安全傳遞給前端 JavaScript 變數。直接輸出會導致語法錯誤或 XSS 風險。本文分析原始 jsformat() 函數缺陷,提供符合現代安全標準的改良版本。
<?php
function jsformat($str) {
$str = trim($str);
$str = str_replace('ss', 's', $str); // ❌ 錯誤:'ss' 非轉義目標
$str = str_replace(chr(10), '', $str); // 移除換行符 LF
$str = str_replace(chr(13), '', $str); // 移除換行符 CR
$str = str_replace(' ', '', $str); // ❌ 過度:移除所有空格
$str = str_replace('', '', $str); // ❌ 無效:空字串替換
$str = str_replace('"', '"', $str); // ❌ HTML 實體非 JS 轉義
$str = str_replace("'", "'", $str); // ❌ 同上
$str = str_replace("'", "'", $str); // ❌ 重複且錯誤
return $str;
}
?>
str_replace('ss', 's') 會破壞正常文字(如 "message" → "mesage")\、/、\t、\b、\f、Unicode 字元")非 JavaScript 字串轉義PHP 5.3+ 內建 json_encode() 完美符合 JavaScript 字串字面量規範(RFC 8259),自動處理:
\n、\r、\t、\b、\f、\\、\")\uXXXX 或 UTF-8 視旗標而定)<?php
$htmlContent = '<div class="alert">Hello "World"</div>';
// 直接輸出到 JS 變數
echo "<script>";
echo "var htmlContent = " . json_encode($htmlContent, JSON_UNESCAPED_UNICODE | JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP) . ";";
echo "</script>";
?>
| 旗標 | 作用 | 建議 |
|---|---|---|
JSON_UNESCAPED_UNICODE | 中文不轉 \uXXXX,保持可讀 | ✅ 建議開啟 |
JSON_HEX_TAG | < > 轉 \u003C \u003E | ✅ 防 XSS 必開 |
JSON_HEX_APOS | ' 轉 \u0027 | ✅ 單引號字串安全 |
JSON_HEX_QUOT | " 轉 \u0022 | ✅ 雙引號字串安全 |
JSON_HEX_AMP | & 轉 \u0026 | ✅ 完整防護 |
<?php
/**
* 將任意字串安全編碼為 JavaScript 字串字面量
* @param string $str 任意字串(含 HTML、特殊字元、Unicode)
* @param bool $withScriptTags 是否包裹 ";
}
return $jsLiteral;
}
// 使用範例
$html = '<div onclick="alert(\'XSS\')">測試 & "引號" </div>';
// 方式 1:直接輸出 JS 變數賦值
echo phpToJsString($html, true);
// 輸出:
// 方式 2:內聯在事件屬性(需額外 HTML 屬性編碼)
echo '<button onclick="doSomething(' . phpToJsString($html) . ')">點擊</button>';
?>
| 方案 | 安全性 | 適用場景 | 備註 |
|---|---|---|---|
json_encode() + 旗標 | ⭐⭐⭐⭐⭐ | 所有 JS 字串注入場景 | 現代 PHP 標準做法 |
htmlspecialchars() | ⭐⭐⭐ | HTML 內容輸出 | 非 JS 語境,無法防 JS 斷注 |
| 自定義 str_replace 陣列 | ⭐ | 教學/極簡環境 | 極易遺漏邊界情況,不推薦 |
JS 端 JSON.parse() | ⭐⭐⭐⭐ | 大型資料傳遞 | 需雙端協作,PHP 輸出 json_encode($data) |
<?php
// Controller / Service 層
$pageData = [
'user' => ['name' => '張三', 'role' => 'admin'],
'config' => ['theme' => 'dark', 'lang' => 'zh-TW'],
'htmlSnippet' => '<div class="widget">內容</div>',
];
// View 層(模板)
?>
<!DOCTYPE html>
<html>
<head>
<script>
// 統一輸出頁面初始化資料
window.APP_INIT = <?= json_encode($pageData, JSON_UNESCAPED_UNICODE | JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP) ?>;
</script>
</head>
<body>
<div id="app"></div>
<script src="app.js"></script>
</body>
</html>
原始 jsformat() 存在嚴重邏輯錯誤與安全缺陷,絕不可用於生產環境。現代 PHP 開發應完全依賴 json_encode() 配合安全旗標,將任意資料安全序列化為 JavaScript 字面量。本文提供的 phpToJsString() 封裝函數可直接納入專案通用庫,徹底解決 PHP→JS 資料傳遞的編碼與安全問題。