- json_decode
- Список параметров
- Возвращаемые значения
- Ошибки
- Список изменений
- Примеры
- Примечания
- Смотрите также
- User Contributed Notes 8 notes
- Как прочитать JSON средствами PHP?
- Пример JSON
- Чтение файла средствами PHP
- Преобразуем JSON в объект PHP
- Преобразуем JSON в массив PHP
- Дополнительные материалы:
- Сергей Мочалов
- Как прочитать JSON с помощью PHP
- Как прочитать содержимое файла
- Как получить значение через запятую в массиве данных файла JSON
- Ошибки при выводе JSON
- Читайте также
- Комментарии к статье “ Как прочитать JSON с помощью PHP ” (2)
json_decode
Принимает закодированную в JSON строку и преобразует её в PHP-значение.
Список параметров
Строка ( string ) json для декодирования.
Функция работает только со строками в кодировке UTF-8.
Замечание:
PHP реализует надмножество JSON, который описан в первоначальном » RFC 7159.
Если true , объекты JSON будут возвращены как ассоциативные массивы ( array ); если false , объекты JSON будут возвращены как объекты ( object ). Если null , объекты JSON будут возвращены как ассоциативные массивы ( array ) или объекты ( object ) в зависимости от того, установлена ли JSON_OBJECT_AS_ARRAY в flags .
Максимальная глубина вложенности структуры, для которой будет производиться декодирование. Значение должно быть больше 0 и меньше или равно 2147483647 .
Битовая маска из констант 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()
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 )
// Закодируем данные с глубиной вложенности 4 (array -> array -> array -> string).
$json = json_encode (
array(
1 => array(
‘English’ => array(
‘One’ ,
‘January’
),
‘French’ => array(
‘Une’ ,
‘Janvier’
)
)
)
);
?php
// Напечатаем ошибки для разных глубин.
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() с большими целыми числами
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() для определения её причины.
Смотрите также
User Contributed Notes 8 notes
JSON can be decoded to PHP arrays by using the $associative = true option. Be wary that associative arrays in PHP can be a «list» or «object» when converted to/from JSON, depending on the keys (of absence of them).
You would expect that recoding and re-encoding will always yield the same JSON string, but take this example:
$json = »;
$array = json_decode($json, true); // decode as associative hash
print json_encode($array) . PHP_EOL;
This will output a different JSON string than the original:
The object has turned into an array!
Similarly, a array that doesn’t have consecutive zero based numerical indexes, will be encoded to a JSON object instead of a list.
$array = [
‘first’,
‘second’,
‘third’,
];
print json_encode($array) . PHP_EOL;
// remove the second element
unset($array[1]);
print json_encode($array) . PHP_EOL;
The array has turned into an object!
In other words, decoding/encoding to/from PHP arrays is not always symmetrical, or might not always return what you expect!
On the other hand, decoding/encoding from/to stdClass objects (the default) is always symmetrical.
Arrays may be somewhat easier to work with/transform than objects. But especially if you need to decode, and re-encode json, it might be prudent to decode to objects and not arrays.
If you want to enforce an array to encode to a JSON list (all array keys will be discarded), use:
If you want to enforce an array to encode to a JSON object, use:
Как прочитать JSON средствами PHP?
Возможно вы знаете что данные в формате JSON (JavaScript Object Notation) могут храниться в виде файлов. Обычно они выглядят как — data.json . Фактически это текстовый файл содержащий данные и отформатированный в соответствии с правилами стандарта JSON в виде пары ключ-значение.
Пример JSON
Чтение файла средствами PHP
Для того чтобы прочитать данные в файле JSON существует функция file_get_content . В самом простом варианте достаточно передать в нее расположение файла JSON и сохранить данные в нужную нам переменную.
Давайте сделаем это и посмотрим что у нас получилось через var_dump :
$ourData = file_get_content("data.json"); var_dump($ourData);
В результате работы вышеописанного кода PHP прочитает данные из файла в переменную $ourData и затем выведет ее содержание:
// Код отформатирован для удобства отображения string(99) "< "name": "Super hero", "town": "Metro City", "formed": "2016", "location": "Super tower" >"
Как видим, данные из файла JSON сохранились в переменную и по сути представляют из себя строку — string
Работать с чистой строкой не особо удобно, поэтому к нам на помощь приходит функция json_decode применить которую можно в нескольких вариантах.
Преобразуем JSON в объект PHP
Вызов функции json_decode в простейшем варианте преобразит строку из файла JSON в PHP объект (Object)
// получаем данные из JSON файла $ourData = file_get_contents("data.json"); // Преобразуем в объект $object = json_decode($ourData); var_dump($object); // выводим объект
В результате мы получим объект PHP:
object(stdClass)#1 (4) < ["name"]=>string(10) "Super hero" ["town"]=> string(10) "Metro City" ["formed"]=> string(4) "2016" ["location"]=> string(11) "Super tower" >
И теперь мы можем обратиться к отдельным элементам объекта:
echo $object->name; // Выведет Super hero echo $object->location; // Выведет Super tower
Преобразуем JSON в массив PHP
Для преобразования в ассоциативный массив воспользуемся функцией json_decode с булевым параметром:
// получаем данные из JSON файла $ourData = file_get_contents("data.json"); // Преобразуем в массив $array = json_decode($ourData, true); var_dump($array); // выводим массив
PHP выведет на странице ассоциативный массив:
array(4) < ["name"]=>string(10) "Super hero" ["town"]=> string(10) "Metro City" ["formed"]=> string(4) "2016" ["location"]=> string(11) "Super tower" >
Это позволяет нам теперь обращаться к отдельным данным массива:
echo $array["town"]; // выведет Metro City
Дополнительные материалы:
В этом уроке мы использовали некоторые базовые функции PHP. Ниже ссылки на их документацию на официальном сайте PHP:
Хочешь стать по-настоящему крутым разработчиком — обучайся в Hexlet.
Сергей Мочалов
Веб-разработчик. Создаю и поддерживаю сайты для клиентов с 2009 года
Как прочитать JSON с помощью PHP
Admin 05.11.2017 , обновлено: 21.12.2017 PHP, WordPress
Формат JSON представляет из себя упорядоченную, определенным образом, информацию. Это альтернатива формату XML, с более минималистической структурой данных. О том, как прочитать эти данные через PHP.
JSON можно прочитать с помощью очень многих языков программирования. Здесь мы будем разбирать пример чтения содержимого файла посредством PHP.
Как прочитать содержимое файла
В переменную f_json заключаем адрес файла JSON:
Затем этот файл достаём по адресу указанному в f_json:
Если заглянуть в JSON файл напрямую, можно увидеть следующие данные:
Иногда в файле данные выглядят так:
Эта «неправильная» кодировка является символами Unicode, записанные в восьмибитной кодировке.
Просмотрим содержимое файла JSON в браузере:
В данном случае будет отдан массив в одну строчку. Ниже строчка разбита, для наглядности, на несколько строк.
object(stdClass)#3896 (1)
< ["response"]=>object(stdClass)#3324 (1)
< ["items"]=>array(1) < [0]=>object(stdClass)#3330 (5)
< ["id"]=>string(4) «1331»
[«title_one»]=> string(40) «Данные заголовка один»
[«title_two»]=> string(38) «Данные заголовка два»
[«Год»]=> string(4) «2056»
[«Items»]=> string(34) «items-1, items-2, items-3, items-4»
> > > >
Для чтения этих данных декодируем строки файла:
Теперь выведем объекты в этом файле. Например, мы хотим достать заголовок один, который находится под ключевым атрибутом title_one. Для этого воспользуемся следующей командой:
Мы сохранили данные в переменную title_one. Теперь с ними можно делать всё что угодно. Например, вывести её:
В этом случае будет показано:
Как получить значение через запятую в массиве данных файла JSON
Пример посложнее. Мы хотим достать отдельные данные для «items-1, items-2, items-3, items-4». Чтобы каждое значение было схвачено в отдельную переменную.
Для этого, сначала мы обратимся к этой строке:
Теперь требуется преобразовать данные из строки в массив. Воспользуемся функцией разбиения строки в PHP:
Теперь мы можем вывести отдельные элементы так:
Причем первое значение выводится с параметром [0]. Так исторически сложилось.
Ошибки при выводе JSON
Если вы сталкиваетесь с командой вроде:
Значит неправильно указан путь к данным.
Читайте также
У сайта нет цели самоокупаться, поэтому на сайте нет рекламы. Но если вам пригодилась информация, можете лайкнуть страницу, оставить комментарий или отправить мне подарок на чашечку кофе.
Комментарии к статье “ Как прочитать JSON с помощью PHP ” (2)
Привет ! подскажи пожалуйста, есть такая задача, скачать и разобрать данные в виде JSON при помощи PHP. Сгенерировать в html страницу , есть ссылка откуда брать json, как это вообще сделать ?? Готовая программа должна скачивать эти данные с файла c помощью ajax
В статье расписано, как разбирать данные json на php. Прочитайте статью и попробуйте сделать что в ней указано. Что касается технологии ajax, то вам отдельно придется её гуглить. На сайте кажется я её ещё не описывал.