JSON 是現代 Web API 標準資料交換格式。本文說明 PHP 端從資料庫查詢、建構陣列、json_encode 輸出,到前端 jQuery AJAX 請求、解析、錯誤處理的完整流程。
<?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);
?>
<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_UNESCAPED_UNICODE | 不轉義 Unicode 字元(中文直接顯示,而非 \uXXXX) |
| JSON_UNESCAPED_SLASHES | 不轉義 / (預設會變成 \/) |
| JSON_NUMERIC_CHECK | 數字字串自動轉為數值型別 |
| JSON_PRESERVE_ZERO_FRACTION | 保留浮點數 .0(如 1.0 不變成 1) |
| JSON_PRETTY_PRINT | 美化縮排(除錯用,生產環境勿開) |