萬盛學電腦網

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

PHP JSON 操作完全指南:編碼、解碼、陣列轉換與巢狀處理

前言

JSON 是現代 Web 開發核心資料交換格式。PHP 內建 json_encode()、json_decode() 提供完整支援,本文系統整理常用操作、參數細節、巢狀結構處理與常見坑點。

基礎操作

JSON 字串 → PHP 變數

<?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 變數 → JSON 字串

<?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)
)
*/
?>

實戰場景:AJAX 回應與資料庫存儲

<?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 返回 nullJSON 格式錯誤(尾隨逗號、單引號、BOM)用 json_last_error_msg() 診斷;在線驗證工具檢查
中文變 \uXXXX預設轉義 Unicode加 JSON_UNESCAPED_UNICODE (PHP 5.4+)
資源/物件無法編碼資源、Closure 不支援先轉為陣列/標量
深度巢狀超過限制預設深度 512json_encode($data, 0, 1024) 調整深度

效能提示

  • 大量資料序列化考慮 igbinary、msgpack 等二進制格式。
  • API 回應啟用 zlib.output_compression 或 Nginx gzip 壓縮 JSON。
copyright © 萬盛學電腦網 all rights reserved