萬盛學電腦網

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

PHP json_encode 陣列轉 JSON 的關鍵行為差異詳解

在前後端分離架構盛行的今天,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 需同時滿足:

  1. 所有鍵為整數數字(或可強制轉換的字串數字)
  2. 鍵從 0 開始連續遞增(0, 1, 2... 無間隙)

因此,顯式指定鍵名也會觸發此行為:

<?php
$b = ['0' => 'Jack', '1' => 'Sam', '2' => 'Tom'];
echo json_encode($b); // 同樣輸出:["Jack","Sam","Tom"]
?>

破壞條件:強制輸出 JSON Object

任一條件不滿足,即輸出 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']
  • 鍵不從 0 開始:[1 => 'a', 2 => 'b']
  • 混合鍵類型:[0 => 'a', 'key' => 'b']

前端影響與最佳實踐

JavaScript 中的差異

特性JSON ArrayJSON Object
length 屬性✅ 存在❌ 不存在
數字索引訪問✅ 支持❌ 不支持
鍵值對結構❌ 無鍵名✅ 擁有鍵名
遍歷方式forEach, for...offor...in, Object.keys()

解決方案

  1. 後端強制輸出 Object:使用 JSON_FORCE_OBJECT 選項
    echo json_encode($a, JSON_FORCE_OBJECT);
  2. 前端統一處理:檢測類型後轉換
    const data = Array.isArray(res) ? Object.assign({}, res) : res;
  3. API 設計規範:明確約定返回結構,避免依賴隱式行為

總結

理解 json_encode 的隱式轉換規則,對於構建穩健的 API 至關重要。開發者應主動控制輸出格式,而非依賴 PHP 的自動判斷,確保前後端數據契約的一致性。

copyright © 萬盛學電腦網 all rights reserved