JSON 是現代 Web 開發核心資料交換格式。PHP 內建 json_encode()、json_decode() 提供完整支援,本文系統整理常用操作、參數細節、巢狀結構處理與常見坑點。
<?php
$json = '{"a":1,"b":2,"c":3,"d":4,"e":5}';
// 解碼為物件 (stdClass)
$obj = json_decode($json);
echo $obj->a; // 1
// 解碼為關聯陣列(推薦,第二參數 true)
$arr = json_decode($json, true);
echo $arr['a']; // 1
?>
<?php
$arr = ['a'=>1, 'b'=>2, 'c'=>3];
$json = json_encode($arr); // '{"a":1,"b":2,"c":3}'
// 常用選項
json_encode($data, JSON_UNESCAPED_UNICODE); // 中文不轉義
json_encode($data, JSON_UNESCAPED_SLASHES); // 不轉義斜線
json_encode($data, JSON_PRETTY_PRINT); // 格式化輸出(除錯用)
// 組合使用
json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
?>
<?php
$json = '{"webname":"homehf","url":"www.homehf.com","contact":{"qq":"123456","mail":"test@test.com"}}';
$obj = json_decode($json);
echo $obj->contact->qq; // 123456
// 遞迴轉為純陣列
function jsonToArray($data) {
if (is_object($data)) $data = (array)$data;
if (is_array($data)) {
return array_map('jsonToArray', $data);
}
return $data;
}
$arr = jsonToArray(json_decode($json));
print_r($arr);
/*
Array
(
[webname] => homehf
[contact] => Array([qq]=>123456 [mail]=>test@test.com)
)
*/
?>
<?php
// Controller 回應 AJAX
header('Content-Type: application/json; charset=utf-8');
$data = ['status'=>200, 'data'=>['id'=>1, 'name'=>'商品A']];
echo json_encode($data, JSON_UNESCAPED_UNICODE);
// 儲存 JSON 到 MySQL JSON 欄位 (MySQL 5.7+)
$pdo->prepare("INSERT INTO settings (config) VALUES (?)")
->execute([json_encode($config, JSON_UNESCAPED_UNICODE)]);
// 讀取並查詢 JSON 欄位
$stmt = $pdo->query("SELECT config->>'$.site_name' AS name FROM settings");
?>
| 錯誤 | 原因 | 解決 |
|---|---|---|
| json_decode 返回 null | JSON 格式錯誤(尾隨逗號、單引號、BOM) | 用 json_last_error_msg() 診斷;在線驗證工具檢查 |
| 中文變 \uXXXX | 預設轉義 Unicode | 加 JSON_UNESCAPED_UNICODE (PHP 5.4+) |
| 資源/物件無法編碼 | 資源、Closure 不支援 | 先轉為陣列/標量 |
| 深度巢狀超過限制 | 預設深度 512 | json_encode($data, 0, 1024) 調整深度 |
igbinary、msgpack 等二進制格式。zlib.output_compression 或 Nginx gzip 壓縮 JSON。