在前後端分離架構盛行的今天,JSON 已成為數據交換的標準格式。PHP 的 json_encode() 是將 PHP 陣列轉換為 JSON 字串的核心函數,但其行為存在一個容易被忽視的細節:數字索引且從 0 開始的連續陣列會被編碼為 JSON 陣列(方括號),而非 JSON 物件(大括號)。這直接影響前端解析邏輯,本文深入剖析這一機制。
考慮以下 PHP 代碼:
<?php
$a = ['Jack', 'Sam', 'Tom'];
echo json_encode($a);
// 輸出:["Jack","Sam","Tom"]
?>
雖然 PHP 中 $a 是關聯陣列的特例(數字鍵),但 json_encode 將其識別為「列表」並輸出 JSON Array。前端 JavaScript 接收後,typeof result === 'object' && Array.isArray(result) 為 true,這可能違背 API 協約(約定返回 Object)。
json_encode 輸出 JSON Array 需同時滿足:
因此,顯式指定鍵名也會觸發此行為:
<?php
$b = ['0' => 'Jack', '1' => 'Sam', '2' => 'Tom'];
echo json_encode($b); // 同樣輸出:["Jack","Sam","Tom"]
?>
任一條件不滿足,即輸出 JSON Object:
<?php
$c = ['person-1' => 'Jack', 'person-2' => 'Sam', 'person-3' => 'Tom'];
echo json_encode($c);
// 輸出:{"person-1":"Jack","person-2":"Sam","person-3":"Tom"}
?>
其他常見破壞場景:
[0 => 'a', 2 => 'b'][1 => 'a', 2 => 'b'][0 => 'a', 'key' => 'b']| 特性 | JSON Array | JSON Object |
|---|---|---|
| length 屬性 | ✅ 存在 | ❌ 不存在 |
| 數字索引訪問 | ✅ 支持 | ❌ 不支持 |
| 鍵值對結構 | ❌ 無鍵名 | ✅ 擁有鍵名 |
| 遍歷方式 | forEach, for...of | for...in, Object.keys() |
JSON_FORCE_OBJECT 選項
echo json_encode($a, JSON_FORCE_OBJECT);
const data = Array.isArray(res) ? Object.assign({}, res) : res;
理解 json_encode 的隱式轉換規則,對於構建穩健的 API 至關重要。開發者應主動控制輸出格式,而非依賴 PHP 的自動判斷,確保前後端數據契約的一致性。