(PHP 5 >= 5.2.0, PECL json >= 1.2.0, PHP 7)
json_decode — Декодирует JSON строку
Описание
Принимает закодированную в JSON строку и преобразует ее в переменную PHP.
Список параметров
json строка ( string ) для декодирования.
Эта функция работает только со строками в UTF-8 кодировке.
PHP реализует надмножество JSON, который описан в первоначальном » RFC 4627, — также кодируя и декодируя скалярные типы и NULL . RFC 4627 поддерживает эти значения только в случае, если они находятся внутри массива или объекта.
И хотя это надмножество согласуется с расширенным определением "JSON текста" из новых » RFC 7159 (который старается заменить собой RFC 4627) и » ECMA-404, это все равно может приводить к проблемам совместимости со старыми парсерами JSON, которые строго придерживаются RFC 4627 с кодированием скалярных значений.
Если TRUE , возвращаемые объекты будут преобразованы в ассоциативные массивы.
Указывает глубину рекурсии.
Битовая маска опций декодирования JSON. В настоящий момент поддерживается только JSON_BIGINT_AS_STRING (по умолчанию большие целые числа приводятся к числам с плавающей запятой (float))
Возвращаемые значения
Возвращает данные json преобразованные в соответствующие типы PHP. Значения true, false и null возвращаются как TRUE , FALSE и NULL соответственно. NULL также возвращается, если json не может быть преобразован или закодированные данные содержат вложенных уровней больше, чем допустимый предел для рекурсий.
Примеры
Пример #1 Пример использования json_decode()
var_dump ( json_decode ( $json ));
var_dump ( json_decode ( $json , true ));
Результат выполнения данного примера:
Пример #2 Доступ к свойствам объектов с неправильными именами
Доступ к элементам объекта, которые содержат символы недопустимые согласно соглашению об именах PHP (т.е. дефис), может производиться путем обрамления имени элемента фигурными скобками и апострофами.
$obj = json_decode ( $json );
print $obj ->< ‘foo-bar’ >; // 12345
Пример #3 Распространенная ошибка при использовании json_decode()
// Следующие строки являются валидным кодом JavaScript, но не валидными JSON данными
// Имя и значение должны помещаться в двойные кавычки
// Одинарные кавычки использовать нельзя
$bad_json = "< ‘bar’: ‘baz’ >" ;
json_decode ( $bad_json ); // null
// Имя должно обрамляться в двойные кавычки
$bad_json = ‘< bar: "baz" >’ ;
json_decode ( $bad_json ); // null
// Не должно быть завершающей запятой (без последующего элемента)
$bad_json = ‘< bar: "baz", >’ ;
json_decode ( $bad_json ); // null
Пример #4 Ошибки с глубиной вложенных объектов ( depth )
// Кодирование данных.
$json = json_encode (
array(
1 => array(
‘English’ => array(
‘One’ ,
‘January’
),
‘French’ => array(
‘Une’ ,
‘Janvier’
)
)
)
);
// Создаем массив с ошибками.
$constants = get_defined_constants ( true );
$json_errors = array();
foreach ( $constants [ "json" ] as $name => $value ) <
if (! strncmp ( $name , "JSON_ERROR_" , 11 )) <
$json_errors [ $value ] = $name ;
>
>
// Отображаем ошибки для разных глубин рекурсий
foreach ( range ( 4 , 3 , — 1 ) as $depth ) <
var_dump ( json_decode ( $json , true , $depth ));
echo ‘Last error: ‘ , $json_errors [ json_last_error ()], PHP_EOL , PHP_EOL ;
>
?>
Результат выполнения данного примера:
Пример #5 json_decode() с большими целыми числами
var_dump ( json_decode ( $json ));
var_dump ( json_decode ( $json , false , 512 , JSON_BIGINT_AS_STRING ));
Результат выполнения данного примера:
Примечания
Спецификация JSON не тоже самое, что и JavaScript, но является его частью.
В случае ошибки декодирования можно использовать json_last_error() для определения ее причины.
Список изменений
Версия | Описание |
---|---|
5.6.0 | Недопустимые варианты true, false и null не в нижнем регистре больше не допускаются во входящих данных, и приводят к предупреждениям. |
5.4.0 | Был добавлен параметр options . |
5.3.0 | Добавлен опциональный параметр depth . Глубина рекурсии по умолчанию увеличено с 128 до 512 |
5.2.3 | Глубина рекурсии увеличена с 20 до 128 |
5.2.1 | Добавлена поддержка декодирования основных типов JSON. |
Смотрите также
- json_encode() — Возвращает JSON-представление данных
- json_last_error() — Возвращает последнюю ошибку
Необходимо декодировать (распарсить) данные в формате json? Просто заполните форму ниже и нажмите кнопку «Декодировать».
Во время разработки часто возникает необходимость проверить корректные ли данные отдает сервер, в случаи с одним уровнем вложенности данных проверить можно и «на глаз», но когда уровней несколько легко запутаться. Для решения этой и подобных проблем, был написан этот декодр.
В полученном результате можно легко проследить вложенность элементов, проверить все ли значения на месте, прочитать строки написанные на русском (в закодированном виде это проблемотично) и т.д.
What can you do with JSON Decoder ?
The JSON Decoder tool like the JSON Viewer, Editor, Beautifier/Formatter, when your json date is minified, it convert JSON Strings to a Friendly Readable Format.
How do I use the tool?
Type or Open your file, Copy and paste your code into the input box below to get result.