PHP 運行在服務端,JavaScript 運行在客戶端。傳遞本質是 PHP 生成包含 JS 代碼/數據的 HTML 響應。關鍵要求:上下文編碼防止 XSS。
<?php
$userData = [
'id' => 123,
'name' => '張三 ', // 惡意輸入
'roles' => ['user', 'editor'],
'settings' => (object)['theme' => 'dark']
];
?>
<!DOCTYPE html>
<html>
<head>
<script>
// JSON.parse 自動處理轉義,最安全
window.APP_INIT = JSON.parse('= json_encode($userData, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP) ?>');
// 或直接 (現代瀏覽器支持模塊腳本)
// const APP_INIT = = json_encode($userData, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP) ?>;
</script>
</head>
<body>...</body>
</html>
關鍵標誌位:JSON_HEX_TAG 轉義 < >,JSON_HEX_APOS 轉義 ',JSON_HEX_QUOT 轉義 ",JSON_HEX_AMP 轉義 &,防止跳出 Script 標籤/屬性上下文。
<div id="app"
data-user-id="= htmlspecialchars($user['id'], ENT_QUOTES, 'UTF-8') ?>"
data-user-name="= htmlspecialchars($user['name'], ENT_QUOTES, 'UTF-8') ?>"
data-roles="= htmlspecialchars(json_encode($user['roles']), ENT_QUOTES, 'UTF-8') ?>">
</div>
<script>
const app = document.getElementById('app');
const userId = app.dataset.userId; // 字符串
const roles = JSON.parse(app.dataset.roles); // 數組
</script>
<?php
// ❌ 危險:無轉義
echo "<script>var user = '$_POST[username]';</script>";
// ✅ 正確:json_encode + 標誌位
echo '<script>var user = ' . json_encode($_POST['username'], JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP) . ';</script>';
?>
<?php
// api/user.php
header('Content-Type: application/json; charset=utf-8');
echo json_encode([
'code' => 0,
'data' => $userData
]);
// 前端
fetch('/api/user.php')
.then(r => r.json())
.then(res => { if (res.code === 0) window.APP_INIT = res.data; });
| 上下文 | PHP 函數 | 關鍵參數 | 示例輸出 |
|---|---|---|---|
| HTML 文本節點 | htmlspecialchars | ENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8' | <script> → <script> |
| HTML 屬性值 | htmlspecialchars | ENT_QUOTES, 'UTF-8' | " → " |
| JavaScript 字符串 | json_encode | JSON_HEX_TAG|JSON_HEX_APOS|JSON_HEX_QUOT|JSON_HEX_AMP | " → \u0022, < → \u003C |
| URL 參數值 | urlencode / rawurlencode | - | 空格 → %20 / + |
| CSS 值 | 無內建 | 需自實現或用 CSS.escape() (JS側) | - |
<?php
// 危險
echo "<script>var x = '$_GET[x]';</script>";
// 攻擊:?x=';alert(1);// → var x = '';alert(1);//';
// 修復
echo '';
<?php
// 危險
echo "<button onclick='doSomething(\"$name\")'>Click</button>";
// 攻擊:name = "); alert(1);// → onclick='doSomething(""); alert(1);//')'
// 修復:避免內聯事件,用 addEventListener + data-*
echo '<button data-name="' . htmlspecialchars($name, ENT_QUOTES, 'UTF-8') . '">Click</button>';
<?php
// 危險
echo $_GET['callback'] . '(' . json_encode($data) . ');';
// 攻擊:callback=alert(1)// → alert(1)//({"data":...});
// 修復:嚴格驗證回調名
$callback = $_GET['callback'] ?? '';
if (!preg_match('/^[a-zA-Z_][a-zA-Z0-9_]*$/', $callback)) {
http_response_code(400); exit('Invalid callback');
}
echo $callback . '(' . json_encode($data) . ');';
<script type="application/json" id="init-data">...</script> 注入,JS 端 JSON.parse(document.getElementById('init-data').textContent)Content-Security-Policy: script-src 'self' 'nonce-xxx'; 禁止內聯腳本執行,強制使用 nonce現代模版引擎默認上下文感知轉義:
| 引擎 | JS 上下文轉義 | 用法 |
|---|---|---|
| Twig | |escape('js') | {{ data|escape('js') }} |
| Blade (Laravel) | @json 指令 | @json($data) 自動包含標誌位 |
| Smarty | |escape:'javascript' | {$data|escape:'javascript'} |
| Lattee | 自動上下文感知 | {$data} 在 <script> 中自動 JS 轉義 |
PHP 向 JavaScript 傳遞變量的核心是 上下文感知編碼。現代開發應優先採用 json_encode + JSON_HEX_* 內聯注入或 API 異步獲取,配合 CSP 與模版引擎自動轉義,從架構層面消除 XSS 風險。