JavaScript (前端) 與 PHP (後端) 運行在**完全不同的環境**:
<!-- HTML 表單 -->
<form action="process.php" method="POST">
<input type="text" name="username" id="username" required>
<input type="email" name="email" id="email" required>
<button type="submit">送出</button>
</form>
<!-- process.php -->
<?php
// PHP 自動解析 $_POST / $_GET
$username = $_POST['username'] ?? '';
$email = $_POST['email'] ?? '';
// 驗證與處理
if ($username && $email) {
// 儲存資料庫...
header('Location: success.php');
exit;
}
?>
<script>
// 前端:發送 JSON 資料
async function submitUserData() {
const formData = {
username: document.getElementById('username').value,
email: document.getElementById('email').value,
// 可包含複雜巢狀物件
profile: {
age: 25,
tags: ['developer', 'php', 'js']
}
};
try {
const response = await fetch('api/user.php', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'Accept': 'application/json',
// CSRF Token (若有)
'X-CSRF-Token': document.querySelector('meta[name="csrf-token"]').content
},
credentials: 'same-origin', // 攜帶 Cookie/Session
body: JSON.stringify(formData)
});
const result = await response.json();
if (!response.ok) {
throw new Error(result.message || `HTTP ${response.status}`);
}
console.log('成功:', result);
showToast('儲存成功!');
} catch (error) {
console.error('失敗:', error);
showToast('錯誤: ' + error.message);
}
}
</script>
<?php
// api/user.php
header('Content-Type: application/json; charset=utf-8');
// 僅允許 POST
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
http_response_code(405);
echo json_encode(['success' => false, 'message' => 'Method Not Allowed']);
exit;
}
// 讀取原始 JSON 輸入流
$input = file_get_contents('php://input');
$data = json_decode($input, true);
if (json_last_error() !== JSON_ERROR_NONE) {
http_response_code(400);
echo json_encode(['success' => false, 'message' => 'Invalid JSON']);
exit;
}
// 驗證 (建議使用專門驗證庫如 respect/validation)
$username = trim($data['username'] ?? '');
$email = trim($data['email'] ?? '');
if (!$username || !$email || !filter_var($email, FILTER_VALIDATE_EMAIL)) {
http_response_code(422);
echo json_encode(['success' => false, 'message' => '參數驗證失敗']);
exit;
}
// 業務邏輯...
$userId = saveUser($username, $email);
// 統一回應格式
echo json_encode([
'success' => true,
'message' => '用戶建立成功',
'data' => ['id' => $userId, 'username' => $username]
]);
?>
<script>
$.ajax({
url: 'api/user.php',
method: 'POST',
dataType: 'json',
contentType: 'application/json',
data: JSON.stringify({username: 'test', email: 'test@example.com'}),
beforeSend: function(xhr) {
xhr.setRequestHeader('X-CSRF-Token', $('meta[name="csrf-token"]').attr('content'));
},
success: function(response) {
if (response.success) alert('成功');
},
error: function(xhr) {
var err = xhr.responseJSON || {message: '未知錯誤'};
alert('失敗: ' + err.message);
}
});
</script>
<?php
// view.php
$userData = [
'id' => 123,
'name' => '張三',
'roles' => ['user', 'editor'],
'permissions' => ['posts.create', 'posts.edit'],
'settings' => ['theme' => 'dark', 'lang' => 'zh-TW']
];
?>
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>用戶儀表板</title>
<!-- 關鍵:使用 json_encode + htmlspecialchars 雙重編碼防 XSS -->
<script>
// 全域初始化資料
window.APP_INIT = {
user: <?= json_encode($userData, JSON_HEX_TAG | JSON_HEX_APOS | JSON_HEX_QUOT | JSON_HEX_AMP) ?>,
csrfToken: '<?= htmlspecialchars(csrf_token(), ENT_QUOTES) ?>',
apiBase: '<?= rtrim(env('APP_URL'), '/') ?>/api'
};
</script>
</head>
<body>
<div id="app"></div>
<script src="/js/app.js"></script>
</body>
</html>
<!-- 單一值 -->
<div id="user-card" data-user-id="<?= $userId ?>" data-role="<?= $role ?>"></div>
<script>
const card = document.getElementById('user-card');
const userId = card.dataset.userId; // 字串
const role = card.dataset.role;
</script>
| 威脅 | 防禦措施 |
|---|---|
| XSS (跨站腳本) | PHP 輸出 JS 時:json_encode($data, JSON_HEX_TAG|JSON_HEX_APOS|JSON_HEX_QUOT|JSON_HEX_AMP);前端避免 innerHTML 用 textContent |
| CSRF (跨站請求偽造) | 所有狀態改變請求攜帶 CSRF Token (Header: X-CSRF-Token);SameSite Cookie |
| SQL 注入 | PDO 預處理語句;絕不拼接 SQL |
| 敏感資料洩露 | 密碼、Token、金鑰**絕不**輸出到前端;API 回應最小化原則 |
| API 濫用 | Rate Limiting (Redis 計數器);JWT/OAuth2 認證;API Key 管理 |
| 點擊劫持 | Header: X-Frame-Options: DENY 或 Content-Security-Policy: frame-ancestors 'none' |
| 格式 | 優點 | 缺點 | 適用場景 |
|---|---|---|---|
| JSON | 通用、支援巢狀、JS 原生解析、人類可讀 | 無二進制支援、無註釋、數字精度限制 | REST API、AJAX、配置、90% 場景 |
| FormData | 支援檔案上傳、瀏覽器原生、自動 multipart | 不可直接 JSON 序列化、需 FormData API | 檔案上傳、表單提交 |
| URLSearchParams | 輕量、URL 編碼、GET 查詢字串 | 僅扁平鍵值對 | 簡單查詢、GET 請求參數 |
| Protocol Buffers | 高效二進制、強型別 Schema、跨語言 | 需編譯步驟、除錯困難、瀏覽器需 WASM | 高效能微服務內部通訊 |
| MessagePack | JSON 相容二進制、無 Schema、體積小 | 瀏覽器需庫支援 | WebSocket 即時通訊、大量資料傳輸 |
<?php
// 錯誤 1:忘記設定 Content-Type
// 導致前端 response.json() 失敗
// 正確:
header('Content-Type: application/json; charset=utf-8');
// 錯誤 2:輸出前有空白/換行/BOM
// 導致 JSON 解析失敗
// 正確:PHP 檔案結尾省略 ?>,或確保無輸出
// 錯誤 3:json_encode 中文被轉義為 \uXXXX
// 正確:JSON_UNESCAPED_UNICODE
echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
// 錯誤 4:前端 fetch 忘記 credentials
// 導致 Session/Cookie 不隨請求發送
// 正確:
fetch(url, {credentials: 'same-origin'});
// 除錯技巧:Network 面板檢查 Request/Response Payload、Headers、Status Code
// PHP 端:error_log(print_r($data, true)); 記錄接收資料
?>
JS ↔ PHP 數據傳遞的現代最佳實踐: