寫接口的同學應該經常遇到數據格式的轉換,這時候最常用的一對函數就是 json_encode() 和 json_decode()。它們使用時有不少需要注意的地方,這裡重點說說 json_decode()。
json_decode() 的作用是對 JSON 格式的字符串進行解碼,接受一個 JSON 字符串並把它轉換為 PHP 變量。
原因一:json_decode 只支持 UTF-8 編碼。
如果數據原本是 GBK,需要先轉碼:
iconv('gbk', 'utf-8', $result_string);
用 iconv 函數把 gbk 編碼轉為 utf-8。注意若原數據本來就是 utf-8,這一步不要做,否則反而會出現亂碼。
原因二:JSON 字符串必須用雙引號包含。
單引號是不合法的 JSON 語法,會直接導致解析失敗:
str_replace("'", '"', $result_string); // 單引號替換為雙引號
原因三:不能有多餘的逗號。例如 [1,2,] 這種尾隨逗號在 JSON 中非法,用正則去掉:
preg_replace('/,\s*([\]}])/m', '$1', $result_string);
這時候需要用到 urlencode() 和 urldecode()。把中文先編碼成 URL 形式(純 ASCII,不會亂碼),傳輸與轉換全程安全,最後輸出前再解碼回來。
下面是完整代碼,經測試有效:
if (file_exists($result['save_path'])) {
$contents = file_get_contents($result['save_path']);
// 文件是 utf-8 格式,裡面是 json 格式的數據
// 若文件原本是 gbk,需先轉碼:
// $contents = iconv("gbk", "utf-8//ignore", $contents);
$getcontent = str_replace("'", '"', $contents); // 單引號換雙引號
preg_replace('/,\s*([\]}])/m', '$1', $getcontent); // 去掉多餘的逗號
$new_array = array();
$new_array = json_decode($getcontent, true);
$res = array();
foreach ($new_array as $key => $val) {
foreach ($new_array[$key]['items'] as $k => $v) {
if ($k < $row) {
$res[$k]['position'] = $v['position'];
$res[$k]['distance'] = $v['distance'];
$res[$k]['title'] = urlencode($v['title']);
$res[$k]['vicinity'] = urlencode($v['vicinity']);
}
}
}
if ($res) {
$new_res['items'] = $res;
} else {
$new_res['items'] = "";
}
echo urldecode(json_encode($new_res));
}
遇到 json_decode 返回 NULL,可以順著這條線依次檢查:編碼是否為 UTF-8 → 引號是否為雙引號 → 有沒有尾隨逗號 → 字符串本身是否完整(file_get_contents 讀取失敗、內容被截斷也會返回 NULL)。
還有一個實用技巧:加上 JSON_THROW_ON_ERROR 參數(PHP 7.3+)讓它拋出異常,或者用 json_last_error_msg() 查看具體錯誤原因,比盲猜高效得多。
另外提醒一句,示例中 preg_replace 的返回值沒有賦回原變量,這是一個疏漏,實戰中需要寫成 $getcontent = preg_replace(...) 才會生效。
以上就是關於 json_decode 亂碼及 NULL 問題的分享,希望對大家有所幫助。