json_last_error

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

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

Açıklama

json_last_error ( ) : int

JSON_THROW_ON_ERROR belirtilmeden yapılan son JSON şifre/deşifre işlemi sırasında (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_STATE_MISMATCH Geçersiz ya da bozuk JSON  
JSON_ERROR_CTRL_CHAR Denetim karakteri hatası, muhtemelen yanlış kodlanmış  
JSON_ERROR_SYNTAX Sözdizimi hatası  
JSON_ERROR_UTF8 Bozuk UTF-8 karakterler, muhtemelen yanlış kodlanmış PHP 5.3.3
JSON_ERROR_RECURSION Kodlanacak değerde bir veya daha fazla özyinelemeli gönderim PHP 5.5.0
JSON_ERROR_INF_OR_NAN Kodlanacak değerde bir veya daha fazla NAN veya INF değeri PHP 5.5.0
JSON_ERROR_UNSUPPORTED_TYPE Kodlanamayan türde bir değer belirtilmiş PHP 5.5.0
JSON_ERROR_INVALID_PROPERTY_NAME Kodlanamayan bir özellik ismi belirtilmiş PHP 7.0.0
JSON_ERROR_UTF16 Bozuk UTF-16 karakterler, muhtemelen yanlış kodlanmış PHP 7.0.0

Ö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_NONE:
            echo 
' - No errors';
        break;
        case 
JSON_ERROR_DEPTH:
            echo 
' - Azami yığın derinliği aşıldı';
        break;
        case 
JSON_ERROR_STATE_MISMATCH:
            echo 
' - Alttan taşma ya da kipler uyumsuz';
        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_UTF8:
            echo 
' - Bozuk UTF-8 karakterler, muhtemelen yanlış kodlanmış';
        break;
        default:
            echo 
' - Bilinmeyen hata';
        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

Örnek 2 - json_last_error() ile json_encode()

<?php
// Geçersiz UTF8 dizesi
$text "\xB1\x31";

$json  json_encode($text);
$error json_last_error();

var_dump($json$error === JSON_ERROR_UTF8);
?>

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

string(4) "null"
bool(true)

Örnek 3 - json_last_error() ve JSON_THROW_ON_ERROR

<?php
// JSON_ERROR_UTF8'e sebep olan geçersiz UTF8 dizesi
json_encode("\xB1\x31");

// Bu bir JSON hatası oluşturmaz
json_encode('okay'JSON_THROW_ON_ERROR);

// Küresel hata durumu eski json_encode() tarafından değiştirilmemiş
var_dump(json_last_error() === JSON_ERROR_UTF8);
?>

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

bool(true)

Ayrıca Bakınız