json_decode

(PHP 5 >= 5.2.0, PHP 7, PHP 8, PECL json >= 1.2.0)

json_decode — Декодує рядок JSON

Опис

json_decode(    string $json,    ?bool $associative = null,    int $depth = 512,    int $flags = 0): mixed

Приймає закодований у 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

Максимальна глибина вкладеності структури, на яку проводитиметься декодування. Значення має бути більшим і менше чи одно 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()

Loading...
▶

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

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 (тобто дефіс), може бути виконаний шляхом обрамлення імені елемента фігурними дужками та апострофами.

Loading...
▶

Приклад #3 Поширена помилка під час використання json_decode()

Loading...
▶

Приклад #4 Помилки з глибиною вкладених об'єктів (depth) .

Loading...
▶

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

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

Приклад #5json_decode()** з великими цілими числами**

Loading...
▶

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

object(stdClass)#1 (1) {
  ["number"]=>
  float(1.2345678901235E+19)
}
object(stdClass)#1 (1) {
  ["number"]=>
  string(20) "12345678901234567890"
}

Примітки

Зауваження :

Специфікація JSON – це не JavaScript, а його підмножина.

Зауваження :

У разі виникнення помилки декодування можна використовувати json_last_error() визначення її причини.

Дивіться також

• json_encode() - Повертає JSON-подання даних
• json_last_error() - Повертає останню помилку