雖然這顯然會在不同版本之間有所改變，但目前的錯誤碼如下：
0 = JSON_ERROR_NONE
1 = JSON_ERROR_DEPTH
2 = JSON_ERROR_STATE_MISMATCH
3 = JSON_ERROR_CTRL_CHAR
4 = JSON_ERROR_SYNTAX
5 = JSON_ERROR_UTF8
我發布這些只是為了讓那些可能正在嘗試理解為什麼特定 JSON 檔案無法被解碼的人參考。請不要將這些數字寫死在錯誤處理常式中。
(PHP 5 >= 5.3.0, PHP 7, PHP 8)
json_last_error — 傳回最後發生的錯誤
此函式沒有參數。
傳回一個整數，其值可以是下列常數之一
| 常數 | 意義 | 可用性 |
|---|---|---|
JSON_ERROR_NONE |
沒有發生錯誤 | |
JSON_ERROR_DEPTH |
超過最大堆疊深度 | |
JSON_ERROR_STATE_MISMATCH |
無效或格式錯誤的 JSON | |
JSON_ERROR_CTRL_CHAR |
控制字元錯誤，可能編碼不正確 | |
JSON_ERROR_SYNTAX |
語法錯誤 | |
JSON_ERROR_UTF8 |
UTF-8 字元格式錯誤，可能編碼不正確 | |
JSON_ERROR_RECURSION |
要編碼的值中有一個或多個遞迴參考 | |
JSON_ERROR_INF_OR_NAN |
要編碼的值中有一個或多個 NAN 或 INF 值 |
|
JSON_ERROR_UNSUPPORTED_TYPE |
給定了一個無法編碼的類型的值 | |
JSON_ERROR_INVALID_PROPERTY_NAME |
給定了一個無法編碼的屬性名稱 | |
JSON_ERROR_UTF16 |
UTF-16 字元格式錯誤，可能編碼不正確 |
範例 #1 json_last_error() 範例
<?php
// 一個有效的 JSON 字串
$json[] = '{"Organization": "PHP Documentation Team"}';
// 一個無效的 JSON 字串，會導致語法錯誤
// 在此例中，我們使用 ' 而不是 " 作為引號
$json[] = "{'Organization': 'PHP Documentation Team'}";
foreach ($json as $string) {
echo '解碼中：' . $string;
json_decode($string);
switch (json_last_error()) {
case JSON_ERROR_NONE:
echo ' - 沒有錯誤';
break;
case JSON_ERROR_DEPTH:
echo ' - 超過最大堆疊深度';
break;
case JSON_ERROR_STATE_MISMATCH:
echo ' - 堆疊下溢或模式不匹配';
break;
case JSON_ERROR_CTRL_CHAR:
echo ' - 找到非預期的控制字元';
break;
case JSON_ERROR_SYNTAX:
echo ' - 語法錯誤，JSON 格式錯誤';
break;
case JSON_ERROR_UTF8:
echo ' - UTF-8 字元格式錯誤，可能編碼不正確';
break;
default:
echo ' - 未知錯誤';
break;
}
echo PHP_EOL;
}
?>以上範例將輸出：
Decoding: {"Organization": "PHP Documentation Team"} - No errors
Decoding: {'Organization': 'PHP Documentation Team'} - Syntax error, malformed JSON
範例 #2 使用 json_encode() 的 json_last_error() 範例
<?php
// 一個無效的 UTF8 序列
$text = "\xB1\x31";
$json = json_encode($text);
$error = json_last_error();
var_dump($json, $error === JSON_ERROR_UTF8);
?>以上範例將輸出：
string(4) "null" bool(true)
範例 #3 json_last_error() 和 JSON_THROW_ON_ERROR
<?php
// 一個會導致 JSON_ERROR_UTF8 的無效 UTF8 序列
json_encode("\xB1\x31");
// 以下不會導致 JSON 錯誤
json_encode('okay', JSON_THROW_ON_ERROR);
// 全域錯誤狀態未被前一個 json_encode() 改變
var_dump(json_last_error() === JSON_ERROR_UTF8);
?>以上範例將輸出：
bool(true)
雖然這顯然會在不同版本之間有所改變，但目前的錯誤碼如下：
0 = JSON_ERROR_NONE
1 = JSON_ERROR_DEPTH
2 = JSON_ERROR_STATE_MISMATCH
3 = JSON_ERROR_CTRL_CHAR
4 = JSON_ERROR_SYNTAX
5 = JSON_ERROR_UTF8
我發布這些只是為了讓那些可能正在嘗試理解為什麼特定 JSON 檔案無法被解碼的人參考。請不要將這些數字寫死在錯誤處理常式中。我使用了這個從 StackOverflow 找到的簡單腳本來避免函式失效
<?php
函式 utf8ize($d) {
如果 (is_array($d)) {
foreach ($d 作為 $k => $v) {
$d[$k] = utf8ize($v);
}
} 否則如果 (is_string ($d)) {
返回 utf8_encode($d);
}
返回 $d;
}
?>
敬上，
Praveen Kumar!當 json_decode 一個空字串時，PHP7 會觸發語法錯誤
<?php
json_decode("");
var_dump(json_last_error(), json_last_error_msg());
// PHP 7
int(4)
string(12) "語法錯誤"
// PHP 5
int(0)
string(8) "沒有錯誤"使用這段程式碼搭配 mb_convert_encoding，您可以 json_encode 一些損壞的 UTF-8 字元
函式 safe_json_encode($value, $options = 0, $depth = 512) {
$encoded = json_encode($value, $options, $depth);
如果 ($encoded === false && $value && json_last_error() == JSON_ERROR_UTF8) {
$encoded = json_encode(utf8ize($value), $options, $depth);
}
返回 $encoded;
}
函式 utf8ize($mixed) {
如果 (is_array($mixed)) {
foreach ($mixed as $key => $value) {
$mixed[$key] = utf8ize($value);
}
} 否則如果 (is_string($mixed)) {
返回 mb_convert_encoding($mixed, "UTF-8", "UTF-8");
}
返回 $mixed;
}我只是加上這段註記，因為我必須為實際的值參考編寫這段程式碼。
<?php
echo JSON_ERROR_NONE . ' JSON_ERROR_NONE' . '<br />';
echo JSON_ERROR_DEPTH . ' JSON_ERROR_DEPTH' . '<br />';
echo JSON_ERROR_STATE_MISMATCH . ' JSON_ERROR_STATE_MISMATCH' . '<br />';
echo JSON_ERROR_CTRL_CHAR . ' JSON_ERROR_CTRL_CHAR' . '<br />';
echo JSON_ERROR_SYNTAX . ' JSON_ERROR_SYNTAX' . '<br />';
echo JSON_ERROR_UTF8 . ' JSON_ERROR_UTF8' . '<br />';
echo JSON_ERROR_RECURSION . ' JSON_ERROR_RECURSION' . '<br />';
echo JSON_ERROR_INF_OR_NAN . ' JSON_ERROR_INF_OR_NAN' . '<br />';
echo JSON_ERROR_UNSUPPORTED_TYPE . ' JSON_ERROR_UNSUPPORTED_TYPE' . '<br />';
/*
以上輸出：
0 JSON_ERROR_NONE
1 JSON_ERROR_DEPTH
2 JSON_ERROR_STATE_MISMATCH
3 JSON_ERROR_CTRL_CHAR
4 JSON_ERROR_SYNTAX
5 JSON_ERROR_UTF8
6 JSON_ERROR_RECURSION
7 JSON_ERROR_INF_OR_NAN
8 JSON_ERROR_UNSUPPORTED_TYPE
*/
?>這是一個相當簡單且實用的技巧，用於驗證 JSON 字串。
<?php
function json_validate($string) {
if (is_string($string)) {
@json_decode($string);
return (json_last_error() === JSON_ERROR_NONE);
}
return false;
}
echo (json_validate('{"test": "valid JSON"}') ? "這是 JSON 格式" : "這不是 JSON 格式"); // 顯示「這是 JSON 格式」
echo (json_validate('{test: valid JSON}') ? "這是 JSON 格式" : "這不是 JSON 格式"); // 因缺少引號，顯示「這不是 JSON 格式」
echo (json_validate(array()) ? "這是 JSON 格式" : "這不是 JSON 格式"); // 因參數非字串，顯示「這不是 JSON 格式」
?>
敬上受保護和私有的屬性會被忽略,
在對類別實例進行 json_encoding 時。
程式碼片段
<?php
類別 範例
{
私有 $privateprop = "私有屬性";
保護 $protectedprop = "保護屬性";
公開 $publicprop = "公開屬性";
}
echo json_encode(new 範例);
?>
只會回傳
{"publicprop":"公開屬性"}這裡是一個小型的 utf8ize 更新版本，新增了以下功能：
* 使用 iconv 取代 utf8_encode，可能會有更好的結果。
* 新增了物件變數的支援。
* 也更新了陣列鍵值（在我遇到的情況中，我必須將鍵值也進行 utf8ize 處理，因為這些鍵值是從使用者輸入的值產生的）。
程式碼如下：
<?php
函式 utf8ize($d) {
if (is_array($d)) {
foreach ($d as $k => $v) {
unset($d[$k]);
$d[utf8ize($k)] = utf8ize($v);
}
} else if (is_object($d)) {
$objVars = get_object_vars($d);
foreach($objVars as $key => $value) {
$d->$key = utf8ize($value);
}
} else if (is_string ($d)) {
return iconv('UTF-8', 'UTF-8//IGNORE', utf8_encode($d));
}
return $d;
}
?>