Что такое «JSON»

JSON вырос из синтаксиса литералов JavaScript и был популяризирован Дугласом Крокфордом в начале 2000-х. Формат настолько прост, что его описание умещается на одной странице, а сейчас он закреплён в стандартах ECMA-404 и RFC 8259. Через JSON отдают данные почти все веб-API, в нём хранят настройки, им обмениваются сайт и мобильное приложение, браузер и сервер.

По сравнению с XML JSON короче и ближе к структурам данных в коде: объект сразу превращается в ассоциативный массив PHP или объект JavaScript, без разбора тегов и атрибутов.

Пример и строгие правила синтаксиса

{
  "id": 1042,
  "status": "paid",
  "total": 21900.5,
  "items": [{ "sku": "A-101", "qty": 4 }],
  "comment": null
}
  • Ключи и строки — только в двойных кавычках.
  • Никаких запятых после последнего элемента.
  • Комментарии не допускаются.
  • Нет отдельного типа для дат: их передают строкой, обычно в формате ISO 8601.

Одна лишняя запятая делает весь документ невалидным, поэтому JSON, собранный вручную, лучше проверять линтером. Для конфигураций, которые пишут люди, иногда выбирают YAML — в нём есть комментарии.

Работа с JSON в PHP

$json = json_encode($order, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR);

try {
    $data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
} catch (JsonException $e) {
    error_log('Bad JSON: ' . $e->getMessage());
}

Флаг JSON_UNESCAPED_UNICODE оставляет кириллицу читаемой вместо последовательностей \u0421. Без JSON_THROW_ON_ERROR функция json_decode при ошибке тихо возвращает null, и проблема обнаруживается позже. В WordPress для ответов на AJAX-запросы есть готовые wp_send_json_success() и wp_send_json_error().

Подводные камни

JavaScript хранит числа как числа с плавающей точкой, и целые больше 9 007 199 254 740 991 (это 2 в степени 53 минус один) теряют точность — длинные идентификаторы заказов из внешних систем безопаснее передавать строкой. Ещё одна частая проблема — невидимый символ BOM в начале файла, из-за которого парсер отказывается читать формально правильный документ.

Связанные термины

Обновлено: 10 октября 2026

Все термины раздела «Backend» ↗