PHP 5.6.29 Released

json_last_error

(PHP 5 >= 5.3.0, PHP 7)

json_last_errorOluşan son hatayı döndürür.

Açıklama

int json_last_error ( void )

Son JSON çözümleyicisi tarafından (varsa) oluşan son hatayı döndürür.

Değiştirgeler

Bu işlevin değiştirgesi yoktur.

Dönen Değerler

Tamsayı döndürür, ve değeri aşağıdaki sabitler olabilir:

JSON hata kodları
Sabit Anlamı Geçerlilik
JSON_ERROR_NONE Hata bulunamadı  
JSON_ERROR_DEPTH Azami yığın derinliği aşıldı  
JSON_ERROR_CTRL_CHAR Denetim karakteri hatası, muhtemelen yanlış kodlanmış  
JSON_ERROR_SYNTAX Sözdizimi hatası  
JSON_ERROR_UTF8 UTF-8 karakter kodlama hatası, muhtemelen yanlış kodlanmış PHP 5.3.1

Örnekler

Örnek 1 json_last_error() örneği

<?php
// Geçerli json dizgesi
$json[] = '{"Organization": "PHP Documentation Team"}';

// Geçersiz json dizgesi sözdizimi hatasına sebep
// olur, bu durumda biz tırnak için ' yerine " 
// kullanırız 
$json[] = "{'Organization': 'PHP Documentation Team'}";


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

    switch(
json_last_error())
    {
        case 
JSON_ERROR_DEPTH:
            echo 
' - Azami yığın derinliği aşıldı';
        break;
        case 
JSON_ERROR_CTRL_CHAR:
            echo 
' - Beklenmeyen kontol karakteri bulundu';
        break;
        case 
JSON_ERROR_SYNTAX:
            echo 
' - Sözdizimi hatası, kusurlu JSON';
        break;
        case 
JSON_ERROR_NONE:
            echo 
' - Hatasız';
        break;
    }

    echo 
PHP_EOL;
}
?>

Yukarıdaki örneğin çıktısı:

Decoding: {"Organization": "PHP Documentation Team"} - Hatasız
Decoding: {'Organization': 'PHP Documentation Team'} - Sözdizimi hatası, kusurlu JSON

Ayrıca Bakınız

add a note add a note

User Contributed Notes 7 notes

up
161
jimmetry at gmail dot com
5 years ago
While this can obviously change between versions, the current error codes are as follows:

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

I'm only posting these for people who may be trying to understand why specific JSON files are not being decoded. Please do not hard-code these numbers into an error handler routine.
up
19
praveenscience at gmail dot com
2 years ago
I used this simple script, flicked from StackOverflow to escape from the function failing:

<?php
   
function utf8ize($d) {
        if (
is_array($d)) {
            foreach (
$d as $k => $v) {
               
$d[$k] = utf8ize($v);
            }
        } else if (
is_string ($d)) {
            return
utf8_encode($d);
        }
        return
$d;
    }
?>

Cheers,
Praveen Kumar!
up
15
hemono at gmail dot com
1 year ago
when json_decode a empty string, PHP7 will trigger an Syntax error:
<?php
json_decode
("");
var_dump(json_last_error(), json_last_error_msg());

// PHP 7
int(4)
string(12) "Syntax error"

//  PHP 5
int(0)
string(8) "No error"
up
2
George Dimitriadis
2 months ago
Just adding this note since I had to code this for the actual values reference.

<?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 />';

/*
The above outputs :
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
*/

?>
up
6
williamprogphp at yahoo dot com dot br
2 years ago
This is a quite simple and functional trick to validate JSON's strings.

<?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"}')  ? "It's a JSON" : "NOT is a JSON"); // prints 'It's a JSON'
   
echo (json_validate('{test: valid JSON}')  ? "It's a JSON" : "NOT is a JSON"); // prints 'NOT is a JSON' due to missing quotes
   
echo (json_validate(array())  ? "It's a JSON" : "NOT is a JSON"); // prints 'NOT is a JSON' due to a non-string argument
?>

Cheers
up
-3
lior at mytopia dot com
7 years ago
For those of you who prefer a more object oriented approach (as I do), here is a fairly simple wrapper that handles errors using exceptions:

<?php

class JSON
{
    public static function
Encode($obj)
    {
        return
json_encode($obj);
    }
   
    public static function
Decode($json, $toAssoc = false)
    {
       
$result = json_decode($json, $toAssoc);
        switch(
json_last_error())
        {
            case
JSON_ERROR_DEPTH:
               
$error ' - Maximum stack depth exceeded';
                break;
            case
JSON_ERROR_CTRL_CHAR:
               
$error = ' - Unexpected control character found';
                break;
            case
JSON_ERROR_SYNTAX:
               
$error = ' - Syntax error, malformed JSON';
                break;
            case
JSON_ERROR_NONE:
            default:
               
$error = '';                   
        }
        if (!empty(
$error))
            throw new
Exception('JSON Error: '.$error);       
       
        return
$result;
    }
}

?>
up
-1
davi dot marcondes dot moreira at gmail dot com
2 months ago
In any case, I've made another approach for the example on this page:

```
<?php

namespace \Json

class Helper
{
   
/**
     * @var array
     */
   
protected $errorReference = [
       
JSON_ERROR_NONE => 'No error has occurred.',
       
JSON_ERROR_DEPTH => 'The maximum stack depth has been exceeded.',
       
JSON_ERROR_STATE_MISMATCH => 'Invalid or malformed JSON.',
       
JSON_ERROR_CTRL_CHAR => 'Control character error, possibly incorrectly encoded.',
       
JSON_ERROR_SYNTAX => 'Syntax error.',
       
JSON_ERROR_UTF8 => 'Malformed UTF-8 characters, possibly incorrectly encoded.',
       
// These last 3 messages are only supported on PHP >= 5.5.
        // See http://php.net/json_last_error#refsect1-function.json-last-error-returnvalues
       
JSON_ERROR_RECURSION => 'One or more recursive references in the value to be encoded.',
       
JSON_ERROR_INF_OR_NAN => 'One or more NAN or INF values in the value to be encoded.',
       
JSON_ERROR_UNSUPPORTED_TYPE => 'A value of a type that cannot be encoded was given.',
    ];
   
/**
     * @var string
     */
   
const JSON_UNKNOWN_ERROR = 'Unknown error.';

   
/**
     * Provides the error message, related to json_last_error().
     *
     * If the error code is not found, returns a default `Unknown error` message.
     *
     * @param int $errorCode Return from json_last_error()
     *
     * @return string The error message.
     */
   
public static function getLastErrorMessage($errorCode)
    {
        if (!
array_key_exists($errorCode, $this->errorReference)) {
            return
self::JSON_UNKNOWN_ERROR;
        }

        return
$this->errorReference[$errorCode];
    }
}
```
To Top