json_last_error

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

    json_last_error — Возвращает последнюю ошибку

    Описание

    json_last_error(): int

    Возвращает последнюю ошибку (если она есть), произошедшую во время последнего кодирования/декодирования JSON если при вызове не использовался флаг JSON_THROW_ON_ERROR.

    Список параметров

    У этой функции нет параметров.

    Возвращаемые значения

    Возвращает целочисленное значение, которое может быть одной из следующих констант:

    Коды ошибок JSON
    КонстантаЗначениеДоступность
    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;
    }
    ?>

    Результат выполнения приведённого примера: 

    Декодируем: {"Organization": "PHP Documentation Team"} - Ошибок нет Декодируем: {'Organization': 'PHP Documentation Team'} - Синтаксическая ошибка, некорректный JSON

    Пример #2 Совместное использование json_last_error() и json_encode()

    <?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
    // Некорректная последовательность UTF8, вызывающая JSON_ERROR_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)

    Смотрите также

    • json_last_error_msg() - Возвращает строку с сообщением об ошибке последнего вызова json_encode() или json_decode()
    • json_decode() - Декодирует строку JSON
    • json_encode() - Возвращает JSON-представление данных
    To Top