Декодирование JSON в PHP с помощью json_decode: подробный разбор

Пример 1: Декодирование сложной вложенной структуры с различными флагами

Показано использование нескольких флагов одновременно: JSON_THROW_ON_ERROR, JSON_BIGINT_AS_STRING и JSON_OBJECT_AS_ARRAY (эквивалент второго параметра true).

$json = '{
  "id": 12345678901234567890,
  "user": {
    "name": "Алексей",
    "attributes": [1, 2, 3]
  }
}';

try {
    $data = json_decode($json, true, 512, JSON_THROW_ON_ERROR | JSON_BIGINT_AS_STRING);
    echo "ID: " . $data['id'] . " (тип: " . gettype($data['id']) . ")\n";
    print_r($data['user']);
} catch (JsonException $e) {
    echo "Ошибка: " . $e->getMessage();
}
  

ID: 12345678901234567890 (тип: string)
Array
(
    [name] => Алексей
    [attributes] => Array
        (
            [0] => 1
            [1] => 2
            [2] => 3
        )
)
  

Пример 2: Рекурсивное преобразование stdClass в массив

Если нужно гарантированно получить многомерный массив даже при отсутствии флага true, можно использовать рекурсивную функцию.

function objectToArray($data) {
    if (is_object($data)) {
        $data = get_object_vars($data);
    }
    if (is_array($data)) {
        return array_map(__FUNCTION__, $data);
    }
    return $data;
}

$json = '{"a":{"b":[1,2,{"c":3}]}}';
$obj = json_decode($json);
$arr = objectToArray($obj);
print_r($arr);
  

Array
(
    [a] => Array
        (
            [b] => Array
                (
                    [0] => 1
                    [1] => 2
                    [2] => Array
                        (
                            [c] => 3
                        )
                )

        )

)
  

Пример 3: Декодирование JSONP (JSON с callback)

Иногда внешние API возвращают JSONP: callback({...}). Необходимо удалить вызов функции и скобки, затем декодировать внутренний JSON.

$jsonp = 'myFunction({"result":"ok","count":42})';
preg_match('/\((.*)\)$/', $jsonp, $matches);
if (isset($matches[1])) {
    $json = $matches[1];
    $data = json_decode($json, true);
    print_r($data);
} else {
    echo "Неверный формат JSONP";
}
  

Array
(
    [result] => ok
    [count] => 42
)
  

Пример 4: Обработка BOM (Byte Order Mark) в JSON строке

Файлы JSON могут содержать BOM в начале (например, UTF-8 BOM: \xEF\xBB\xBF). Необходимо удалить его перед декодированием.

$jsonWithBom = "\xEF\xBB\xBF{\"key\":\"value\"}";
$json = ltrim($jsonWithBom, "\xEF\xBB\xBF");
$data = json_decode($json, true);
print_r($data);
  

Array ( [key] => value )
  

Пример 5: Декодирование с проверкой типов полученных данных

Иногда требуется убедиться, что определённое поле имеет ожидаемый тип (например, число, а не строка). Используйте is_int, is_string и т.д.

$json = '{"age":"25"}';
$data = json_decode($json, true);

if (isset($data['age'])) {
    // Принудительное преобразование, если нужно число
    $age = (int)$data['age'];
    echo $age; // 25
}
  

25
  

Пример 6: Декодирование с пользовательским обработчиком ошибок

Можно создать функцию-обёртку, которая логирует все ошибки декодирования.

function safeJsonDecode($json, $assoc = false, $depth = 512, $flags = 0) {
    $result = json_decode($json, $assoc, $depth, $flags);
    if (json_last_error() !== JSON_ERROR_NONE) {
        error_log('JSON decode error: ' . json_last_error_msg() . ' for input: ' . substr($json, 0, 100));
        return null;
    }
    return $result;
}

$data = safeJsonDecode('{"valid":true}');
var_dump($data);
  

object(stdClass)#1 (1) { ["valid"]=> bool(true) }