PHP數組轉JSON常見問題及調試技巧詳解

M66 2025-07-17

PHP數組轉換為JSON時常見問題及調試指南

將PHP數組轉換為JSON是開發中經常遇到的操作，但過程中難免會碰到一些問題。本文總結了幾種常見的錯誤類型及對應的調試方法，助你快速定位並解決轉換問題。

循環引用導致json_encode失敗

當數組中存在循環引用時，調用json_encode()往往會失敗且無錯誤提示。這是因為數組元素互相引用，導致編碼陷入死循環。

解決方案是避免循環引用，或者在調用json_encode()時加入JSON_UNESCAPED_SLASHES選項來嘗試忽略轉義的斜杠，從而緩解此類問題。

 $array = ['foo', ['bar' => $array]]; // 循環引用
$json = json_encode($array, JSON_UNESCAPED_SLASHES); // 解决循環引用问题

UTF-8編碼問題導致亂碼

JSON要求字符串必須是UTF-8編碼。如果輸入數組的字符編碼不正確，生成的JSON可能出現亂碼。

建議確保PHP文件及編輯器均使用UTF-8編碼，同時在json_encode()中使用JSON_UNESCAPED_UNICODE選項，或者藉助mb_convert_encoding()函數將數組元素轉換為UTF-8編碼。

JSON格式錯誤導致解析失敗

JSON格式要求嚴格，缺少引號或逗號會導致解析失敗。

調試時應仔細檢查輸出的JSON字符串格式，可以藉助在線JSON校驗工具來驗證格式正確性。

實戰示例：PHP數組轉JSON

假設有如下數組：

 $array = [
    'name' => 'John Doe',
    'age' => 30,
    'address' => [
        'street' => 'Main Street',
        'city' => 'Anytown'
    ]
];

轉換為JSON的代碼：

 $json = json_encode($array, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
echo $json; // 輸出：{"name":"John Doe","age":30,"address":{"street":"Main Street","city":"Anytown"}}

通過以上步驟，可以有效避免常見問題，確保JSON數據的正確性和完整性。