萬盛學電腦網

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

PHP JSON 編碼與前端 AJAX 串接實務

前言

JSON 是現代 Web API 標準資料交換格式。本文說明 PHP 端從資料庫查詢、建構陣列、json_encode 輸出,到前端 jQuery AJAX 請求、解析、錯誤處理的完整流程。

後端 PHP 實作

<?php
// api/data.php
header('Content-Type: application/json; charset=UTF-8');

// 1. 連線資料庫(PDO 範例)
$pdo = new PDO('mysql:host=127.0.0.1;dbname=test;charset=utf8mb4', 'user', 'pass', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);

// 2. 取得查詢參數
$beginTime = $_GET['BeginTime'] ?? '';
$endTime = $_GET['EndTime'] ?? '';
$keyword = $_GET['keyword'] ?? '';

// 3. 建構查詢
$sql = 'SELECT EventDate, data FROM statistics WHERE 1=1';
$params = [];
if ($beginTime) { $sql .= ' AND EventDate >= ?'; $params[] = $beginTime; }
if ($endTime) { $sql .= ' AND EventDate <= ?'; $params[] = $endTime; }
if ($keyword) { $sql .= ' AND label LIKE ?'; $params[] = "%$keyword%"; }
$sql .= ' ORDER BY EventDate';

$stmt = $pdo->prepare($sql);
$stmt->execute($params);
$rows = $stmt->fetchAll();

// 4. 重組資料結構
$xData = [];
$yData = [];
foreach ($rows as $row) {
    $xData[] = $row['EventDate'];
    $yData[] = (int)$row['data'];
}

// 5. 輸出 JSON
$response = [
    'code' => 200,
    'message' => 'success',
    'data' => [
        'xAxis' => $xData,
        'series' => $yData,
    ],
];

// JSON 選項
$options = JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_NUMERIC_CHECK;
echo json_encode($response, $options);
?>

前端 AJAX 串接 (jQuery)

<script src="https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js"></script>
<script>
$.ajax({
    url: 'api/data.php',
    type: 'GET',
    dataType: 'json', // 自動解析 JSON
    cache: false,
    data: {
        BeginTime: '2024-01-01',
        EndTime: '2024-12-31',
        keyword: 'sales'
    },
    success: function(res) {
        if (res.code === 200) {
            var xData = res.data.xAxis;
            var yData = res.data.series;
            // 繪圖、渲染表格等...
            console.log('取得資料:', xData.length, '筆');
        } else {
            alert('API 錯誤: ' + res.message);
        }
    },
    error: function(xhr, status, error) {
        console.error('AJAX 錯誤:', status, error);
        alert('請求失敗,請稍後再試');
    }
});
</script>

json_encode 關鍵選項

常見問題與解決

  • 中文亂碼:確認資料庫連線 charset=utf8mb4、PHP 檔案儲存為 UTF-8、輸出 header 含 charset=UTF-8、使用 JSON_UNESCAPED_UNICODE。
  • 前端收到字串而非物件:確認 dataType: 'json' 或手動 JSON.parse();檢查 PHP 是否有額外輸出(echo、var_dump、空白字元)。
  • 大數據量效能:分頁、資料壓縮(gzip)、或改用 Server-Sent Events / WebSocket。
  • 跨域 (CORS):PHP 加入 header('Access-Control-Allow-Origin: *'); 或特定域名。

安全性建議

  • 使用 PDO 預處理語句防止 SQL 注入。
  • 輸出前驗證/清理資料。
  • 敏感 API 加入 Token/JWT 驗證。
  • 限制請求頻率。

總結

PHP json_encode + 前端 dataType: 'json' 是標準 AJAX 串接模式。掌握編碼選項、錯誤處理、CORS 設定,即可建構穩健的前後端分離介面。

copyright © 萬盛學電腦網 all rights reserved
常數說明
JSON_UNESCAPED_UNICODE不轉義 Unicode 字元(中文直接顯示,而非 \uXXXX)
JSON_UNESCAPED_SLASHES不轉義 / (預設會變成 \/)
JSON_NUMERIC_CHECK數字字串自動轉為數值型別
JSON_PRESERVE_ZERO_FRACTION保留浮點數 .0(如 1.0 不變成 1)
JSON_PRETTY_PRINT美化縮排(除錯用,生產環境勿開)