json_decode
Принимает закодированную в 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 ));
Результат выполнения данного примера:
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 (т.е. дефис), может производиться путем обрамления имени элемента фигурными скобками и апострофами.
$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 )
// Создаем массив с ошибками.
$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 ;
>
?>
Результат выполнения данного примера:
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" > > > Last error: JSON_ERROR_NONE NULL Last error: JSON_ERROR_DEPTH
Пример #5 json_decode() с большими целыми числами
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() для определения ее причины.
Список изменений
Версия | Описание |
---|---|
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. |