(PHP 5 >= 5.3.0, PHP 7, PHP 8)
json_last_error — Oluşan son hatayı döndürür.
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.
Bu işlevin bağımsız değişkeni yoktur.
Tamsayı döndürür, ve değeri aşağıdaki sabitler olabilir:
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ış | |
JSON_ERROR_RECURSION | Kodlanacak değerde bir veya daha fazla özyinelemeli gönderim | |
JSON_ERROR_INF_OR_NAN | Kodlanacak değerde bir veya daha fazla NAN veya INF değeri | |
JSON_ERROR_UNSUPPORTED_TYPE | Kodlanamayan türde bir değer belirtilmiş | |
JSON_ERROR_INVALID_PROPERTY_NAME | Kodlanamayan bir özellik ismi belirtilmiş | |
JSON_ERROR_UTF16 | Bozuk UTF-16 karakterler, muhtemelen yanlış kodlanmış |
Ö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)