json_last_error

(PHP 5 >= 5.3.0, PHP 7)

json_last_error — 返回最后发生的错误

说明

json_last_error ( void ) : int

如果有，返回 JSON 编码解码时最后发生的错误。

参数

此函数没有参数。

返回值

返回一个整型（integer），这个值会是以下的常量之一：

JSON 错误码
常量 含义 可用性
JSON_ERROR_NONE 没有错误发生  
JSON_ERROR_DEPTH 到达了最大堆栈深度  
JSON_ERROR_STATE_MISMATCH 无效或异常的 JSON  
JSON_ERROR_CTRL_CHAR 控制字符错误，可能是编码不对  
JSON_ERROR_SYNTAX 语法错误  
JSON_ERROR_UTF8 异常的 UTF-8 字符，也许是因为不正确的编码。 PHP 5.3.3
JSON_ERROR_RECURSION One or more recursive references in the value to be encoded PHP 5.5.0
JSON_ERROR_INF_OR_NAN One or more NAN or INF values in the value to be encoded PHP 5.5.0
JSON_ERROR_UNSUPPORTED_TYPE 指定的类型，值无法编码。 PHP 5.5.0
JSON_ERROR_INVALID_PROPERTY_NAME 指定的属性名无法编码。 PHP 7.0.0
JSON_ERROR_UTF16 畸形的 UTF-16 字符，可能因为字符编码不正确。 PHP 7.0.0

范例

Example #1 json_last_error() 例子

<?php
// 一个有效的 json 字符串
$json[] = '{"Organization": "PHP Documentation Team"}';

// 一个无效的 json 字符串会导致一个语法错误，在这个例子里我们使用 ' 代替了 " 作为引号
$json[] = "{'Organization': 'PHP Documentation Team'}";


foreach ($json as $string) {
    echo 'Decoding: ' . $string;
    json_decode($string);

    switch (json_last_error()) {
        case JSON_ERROR_NONE:
            echo ' - No errors';
        break;
        case JSON_ERROR_DEPTH:
            echo ' - Maximum stack depth exceeded';
        break;
        case JSON_ERROR_STATE_MISMATCH:
            echo ' - Underflow or the modes mismatch';
        break;
        case JSON_ERROR_CTRL_CHAR:
            echo ' - Unexpected control character found';
        break;
        case JSON_ERROR_SYNTAX:
            echo ' - Syntax error, malformed JSON';
        break;
        case JSON_ERROR_UTF8:
            echo ' - Malformed UTF-8 characters, possibly incorrectly encoded';
        break;
        default:
            echo ' - Unknown error';
        break;
    }

    echo PHP_EOL;
}
?>

以上例程会输出：

Decoding: {"Organization": "PHP Documentation Team"} - No errors
Decoding: {'Organization': 'PHP Documentation Team'} - Syntax error, malformed JSON

Example #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)

参见

相关文章
php bzip2 函数 返回包含 bzip2 错误号和错误字符串的一个 arrayphp bzip2 函数 返回一个 bzip2 的错误字符串php curl 函数 返回最后一次的错误代码php curl 函数 返回当前会话最后一次错误的字符串php curl 函数 返回共享 curl 句柄的最后一次错误号php curl 函数 返回错误号对应的错误消息php curl 函数 返回错误代码的字符串描述php 错误处理 函数 获取最后发生的错误php fann 函数 返回最后一个错误数字。php fann 函数 返回最后的错误字符串。php fann 函数 重置最后的错误代码。php ftp 函数 返回指定文件的最后修改时间php json 函数 返回最后发生的错误php mysqlnd ms 函数 返回最后的全局同步 id gtid php oci8 函数 返回上一个错误php openssl 函数 返回 openssl 错误消息php postgresql 函数 得到某连接的最后一条错误信息php pcre 函数 返回最后一个pcre正则执行产生的错误代码php socket 函数 清除套接字或者最后的错误代码上的错误php mysqli 返回最近函数调用的错误代码
关注编程学问公众号