萬盛學電腦網

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

PHP 轉義輸出 HTML 至 JavaScript 完整解決方案:jsformat 函數深度解析與改良

應用場景

在 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;
}
?>

嚴重缺陷

  1. 邏輯錯誤:str_replace('ss', 's') 會破壞正常文字(如 "message" → "mesage")
  2. 轉義不完整:未處理 \、/、\t、\b、\f、Unicode 字元
  3. 混淆編碼層級:HTML 實體(")非 JavaScript 字串轉義
  4. 移除空格:破壞原始內容結構

正確解決方案:json_encode() 專用於 JS 字串

PHP 5.3+ 內建 json_encode() 完美符合 JavaScript 字串字面量規範(RFC 8259),自動處理:

  • 控制字元(\n、\r、\t、\b、\f、\\、\")
  • Unicode 字元(輸出 \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 資料傳遞的編碼與安全問題。

copyright © 萬盛學電腦網 all rights reserved