萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> 資料庫綜合

jQuery + PHP + Ajax + JSON 交互完整實戰:從前端請求到後端響應規範

構建健壯的前後端數據交互標準流程

前後端分離架構下,規範化的 Ajax/JSON 交互協議至關重要。本文提供生產級代碼模板,涵蓋緩存控制、錯誤處理、PHP 統一響應格式、前端渲染邏輯。

前端:$.ajax 完整配置(推薦,無緩存、可控錯誤)

$.ajax({
    type: "GET",
    url: "index.php",
    cache: false,                    // 關鍵:防止 IE/Edge 緩存 GET 請求
    data: {
        con: "Add",
        act: "_search",
        key: key,
        id: id
    },
    dataType: "json",
    success: function(response) {
        if (response.error === 0) {
            bindGroupList(response.content);
        } else {
            showError(response.message);
        }
    },
    error: function(xhr, status, err) {
        console.error("請求失敗:", status, err);
        showError("網絡異常,請稍後重試");
    }
});

前端:$.getJSON 簡寫版(有緩存風險,僅適合簡單場景)

$.getJSON("index.php", {
    con: "Add", act: "_search", key: key, id: id
}, function(response) {
    if (response.error === 0) bindGroupList(response.content);
});

渲染邏輯:動態填充 Select 選項

function bindGroupList(data) {
    var $select = $('select[name="group_id"]');
    $select.empty().append(''); // 保留首項
    $.each(data, function(i, item) {
        $select.append($('

後端 PHP:統一 JSON 響應規範

<?php
/**
 * 統一響應格式
 * @param mixed  $content 業務數據
 * @param int    $error   錯誤碼:0 成功,非 0 失敗
 * @param string $message 提示信息
 * @param array  $append  額外字段
 */
function make_json_response($content = '', $error = 0, $message = '', $append = []) {
    $res = [
        'error'   => $error,
        'message' => $message,
        'content' => $content
    ];
    if ($append) $res = array_merge($res, $append);
    header('Content-Type: application/json; charset=utf-8');
    exit(json_encode($res, JSON_UNESCAPED_UNICODE));
}

// 成功快捷方法
function make_json_result($content, $message = '', $append = []) {
    make_json_response($content, 0, $message, $append);
}

// 業務邏輯示例
$list = [
    ['id' => 1, 'name' => '分組A'],
    ['id' => 2, 'name' => '分組B']
];
make_json_result($list); // 輸出:{"error":0,"message":"","content":[...]}

關鍵最佳實踐

  1. 統一響應結構:永遠包含 error、message、content 三字段,前端統一判斷 error === 0。
  2. HTTP 狀態碼語義化:業務失敗返回 200 + error>0;系統級錯誤(權限、找不到路由)返回 4xx/5xx。
  3. 輸出編碼:JSON_UNESCAPED_UNICODE 避免中文被轉義為 \uXXXX,減小傳輸體積。
  4. 安全防範:輸入驗證、SQL 參數化、XSS 過濾、CSRF Token 驗證(狀態改變操作)。
  5. 緩存策略:GET 請求必加 cache: false 或後端發送 Cache-Control: no-cache;POST 天然無緩存。

遵循此規範,前後端協作效率與系統穩定性雙提升。

copyright © 萬盛學電腦網 all rights reserved