萬盛學電腦網

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

PHP 向 JavaScript 傳遞變量的多種方式與安全實踐

一、核心原則

PHP 運行在服務端,JavaScript 運行在客戶端。傳遞本質是 PHP 生成包含 JS 代碼/數據的 HTML 響應。關鍵要求:上下文編碼防止 XSS。

二、主要傳遞方式

1. 內聯 Script 標籤 + json_encode(推薦)

<?php
$userData = [
    'id' => 123,
    'name' => '張三 ', // 惡意輸入
    'roles' => ['user', 'editor'],
    'settings' => (object)['theme' => 'dark']
];
?>
<!DOCTYPE html>
<html>
<head>
    <script>
    // JSON.parse 自動處理轉義,最安全
    window.APP_INIT = JSON.parse('');
    // 或直接 (現代瀏覽器支持模塊腳本)
    // const APP_INIT = ;
    </script>
</head>
<body>...</body>
</html>

關鍵標誌位:JSON_HEX_TAG 轉義 < >,JSON_HEX_APOS 轉義 ',JSON_HEX_QUOT 轉義 ",JSON_HEX_AMP 轉義 &,防止跳出 Script 標籤/屬性上下文。

2. data-* 屬性(簡單數據)

<div id="app" 
     data-user-id=""
     data-user-name=""
     data-roles="">
</div>

<script>
const app = document.getElementById('app');
const userId = app.dataset.userId; // 字符串
const roles = JSON.parse(app.dataset.roles); // 數組
</script>

3. 全局變量直接輸出(舊項目常見,需嚴格轉義)

<?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>';
?>

4. AJAX / Fetch 異步獲取(現代標準)

<?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 文本節點htmlspecialcharsENT_QUOTES | ENT_SUBSTITUTE, 'UTF-8'<script> → &lt;script&gt;
HTML 屬性值htmlspecialcharsENT_QUOTES, 'UTF-8'" → &quot;
JavaScript 字符串json_encodeJSON_HEX_TAG|JSON_HEX_APOS|JSON_HEX_QUOT|JSON_HEX_AMP" → \u0022, < → \u003C
URL 參數值urlencode / rawurlencode-空格 → %20 / +
CSS 值無內建需自實現或用 CSS.escape() (JS側)-

四、常見漏洞與修復

漏洞 1:直接輸出未轉義變量

<?php
// 危險
echo "<script>var x = '$_GET[x]';</script>";
// 攻擊:?x=';alert(1);// → var x = '';alert(1);//';

// 修復
echo '';

漏洞 2:在 HTML 事件屬性中輸出

<?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>';

漏洞 3:JSONP 回調函數名未驗證

<?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) . ');';

五、現代最佳實踐架構

  1. 初始化數據注入:頁面加載時通過 <script type="application/json" id="init-data">...</script> 注入,JS 端 JSON.parse(document.getElementById('init-data').textContent)
  2. API 分離:業務數據通過 REST/GraphQL API 異步獲取,減少首屏內聯數據
  3. CSP 標頭:Content-Security-Policy: script-src 'self' 'nonce-xxx'; 禁止內聯腳本執行,強制使用 nonce
  4. TypeScript 類型定義:從 API Schema 自動生成 TS 類型,端到端類型安全

六、模版引擎自動轉義

現代模版引擎默認上下文感知轉義:

引擎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 風險。

copyright © 萬盛學電腦網 all rights reserved