Что такое «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

