array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.json-decode.php', 1 => 'json_decode', ), 'up' => array ( 0 => 'ref.json.php', 1 => 'Функции JSON', ), 'prev' => array ( 0 => 'ref.json.php', 1 => 'Функции JSON', ), 'next' => array ( 0 => 'function.json-encode.php', 1 => 'json_encode', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/json/functions/json-decode.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 5 >= 5.2.0, PHP 7, PHP 8, PECL json >= 1.2.0)
json_decode — Декодирует строку JSON
Принимает закодированную в JSON строку и преобразовывает её в PHP-значение.
json
Строка (string) json
для декодирования.
Функция работает только со строками в кодировке UTF-8.
Замечание:
PHP реализует расширенный набор JSON, который описывает исходный стандарт » RFC 7159.
associative
Если true
, объекты JSON будут возвращены как
ассоциативные массивы (array); если false
, объекты JSON будут возвращены как объекты (object).
Если null
, объекты JSON будут возвращены как ассоциативные массивы (array) или
объекты (object) в зависимости от того, установлена ли JSON_OBJECT_AS_ARRAY
в flags
.
depth
Максимальная глубина вложенности структуры, для которой будет производиться декодирование.
Значение должно быть больше 0
и меньше или равно 2147483647
.
flags
Битовая маска из констант
JSON_BIGINT_AS_STRING
,
JSON_INVALID_UTF8_IGNORE
,
JSON_INVALID_UTF8_SUBSTITUTE
,
JSON_OBJECT_AS_ARRAY
,
JSON_THROW_ON_ERROR
.
Поведение этих констант описаны на странице
JSON-констант.
Возвращает данные json
, преобразованные
в типы PHP. Не заключённые в кавычки значения true
, false
и null
возвращаются как типизированные значения true
,
false
и null
. Значение с типом null
также возвращается в случаях, когда
параметр json
не может быть преобразован или глубина вложенности структуры
превышет установленный предел.
Начиная с PHP 8.0.0, если значение параметра depth
выходит за пределы допустимого диапазона,
функция выбрасывает исключение ValueError;
ранее выдавалась ошибка уровня E_WARNING
.
Версия | Описание |
---|---|
7.3.0 |
Добавлена константа JSON_THROW_ON_ERROR
для параметра flags .
|
7.2.0 |
associative теперь nullable.
|
7.2.0 |
Добавлены константы
JSON_INVALID_UTF8_IGNORE и
JSON_INVALID_UTF8_SUBSTITUTE
для параметра flags .
|
7.1.0 |
Пустой ключ JSON ("") будет преобразован в пустое свойство объекта, а не
в свойство со значением _empty_ .
|
Пример #1 Примеры использования json_decode()
<?php
$json = '{"a":1,"b":2,"c":3,"d":4,"e":5}';
var_dump(json_decode($json));
var_dump(json_decode($json, true));
?>
Результат выполнения приведённого примера:
object(stdClass)#1 (5) { ["a"] => int(1) ["b"] => int(2) ["c"] => int(3) ["d"] => int(4) ["e"] => int(5) } array(5) { ["a"] => int(1) ["b"] => int(2) ["c"] => int(3) ["d"] => int(4) ["e"] => int(5) }
Пример #2 Доступ к свойствам объектов с неправильными именами
Доступ к элементам объекта, которые содержат символы, недопустимые в соответствии с соглашением об именах PHP (то есть дефис), может быть выполнен путём обрамления имени элемента фигурными скобками и апострофами.
<?php
$json = '{"foo-bar": 12345}';
$obj = json_decode($json);
print $obj->{'foo-bar'}; // 12345
?>
Пример #3 Распространённая ошибка при использовании json_decode()
<?php
// Следующие строки являются валидным кодом 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
)
<?php
// Закодируем данные с глубиной вложенности 4 (array -> array -> array -> string).
$json = json_encode(
array(
1 => array(
'English' => array(
'One',
'January'
),
'French' => array(
'Une',
'Janvier'
)
)
)
);
// Напечатаем ошибки для разных глубин.
var_dump(json_decode($json, true, 4));
echo 'Последняя ошибка: ', json_last_error_msg(), PHP_EOL, PHP_EOL;
var_dump(json_decode($json, true, 3));
echo 'Последняя ошибка: ', json_last_error_msg(), PHP_EOL, PHP_EOL;
?>
Результат выполнения приведённого примера:
array(1) { [1]=> array(2) { ["English"]=> array(2) { [0]=> string(3) "One" [1]=> string(7) "January" } ["French"]=> array(2) { [0]=> string(3) "Une" [1]=> string(7) "Janvier" } } } Последняя ошибка: No error NULL Последняя ошибка: Maximum stack depth exceeded
Пример #5 json_decode() с большими целыми числами
<?php
$json = '{"number": 12345678901234567890}';
var_dump(json_decode($json));
var_dump(json_decode($json, false, 512, JSON_BIGINT_AS_STRING));
?>
Результат выполнения приведённого примера:
object(stdClass)#1 (1) { ["number"]=> float(1.2345678901235E+19) } object(stdClass)#1 (1) { ["number"]=> string(20) "12345678901234567890" }
Замечание:
Спецификация JSON - это не JavaScript, а его подмножество.
Замечание:
В случае возникновения ошибки декодирования можно использовать json_last_error() для определения её причины.