萬盛學電腦網

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

JavaScript 與 PHP 數據傳遞完整指南:表單、AJAX、JSON API 與安全最佳實踐

核心概念:前後端分離的數據流向

JavaScript (前端) 與 PHP (後端) 運行在**完全不同的環境**:

  • JS:瀏覽器端執行,可操作 DOM、發起網路請求、讀寫 localStorage
  • PHP:伺服器端執行,處理業務邏輯、資料庫操作、生成回應
  • 橋樑:HTTP 請求/回應 (Form Submit, AJAX/Fetch, WebSocket)

方式一:傳統表單提交 (同步、頁面跳轉)

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

方式二:AJAX / Fetch API (非同步、無刷新)

原生 Fetch (現代標準)

<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 接收 JSON 請求

<?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]
]);
?>

jQuery AJAX (舊專案維護)

<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 向 JavaScript 傳遞初始化數據

內聯 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>

資料屬性 (data-*) 傳遞簡單值

<!-- 單一值 -->
<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高效能微服務內部通訊
MessagePackJSON 相容二進制、無 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 數據傳遞的現代最佳實踐:

  1. API 介面統一用 JSON:`Content-Type: application/json` + `json_encode`/`json_decode`
  2. 前端用 Fetch API:Promise-based、標準化、支援串流
  3. PHP 讀取 `php://input`** 獲取原始請求體
  4. 安全三寶:CSRF Token、XSS 防護 (JSON_HEX_TAG)、最小權限原則
  5. 統一回應格式:`{success, message, data, meta}` 便於前端統一處理
  6. 初始化資料用內聯 Script:`window.APP_INIT = ` 避免額外請求
copyright © 萬盛學電腦網 all rights reserved