Когда фронтенд обращается к бэкенду, мобильное приложение загружает каталог товаров через REST API, а микросервисы обмениваются состояниями в фоне, им нужен легкий, однозначный и машиночитаемый формат передачи данных. Сегодня этим стандартом де-факто является JSON (JavaScript Object Notation).
Несмотря на название, которое отсылает к синтаксису объектов в JavaScript, JSON является независимым от языков программирования текстовым форматом. Его поддерживают Python, PHP, JavaScript/Node.js, Go, C#, Rust и большинство современных СУБД (PostgreSQL, MySQL, MariaDB) благодаря встроенным типам и функциям для работы с JSON.
Основные правила и типы данных JSON
Синтаксис JSON намеренно сделан минималистическим и строгим, чтобы избежать неоднозначности во время парсинга на разных платформах:
- Пара «ключ – значение»: Объекты записываются в фигурных скобках
{}, где каждый ключ обязательно берется в двойные кавычки"key": value, а пары разделяются запятыми. - Массивы (Arrays): Упорядоченные списки значений в квадратных скобках
[], например["read", "write", "deploy"]. - Поддерживаемые типы значений: Строки (только в двойных кавычках
"..."), числа (целые и с плавающей точкой, без ведущих нулей), булевые значения (true/falseобъекты и массивы. - Никаких комментариев и «висящих» запятых: Стандартный JSON не поддерживает комментарии (
//или/* */) и запятую после последнего элемента объекта или массива – это приведет к ошибке парсинга.
Сравнительный анализ: JSON против XML и YAML
| Критерий | JSON | XML | YAML |
|---|---|---|---|
| Читабельность для человека | Высокая (компактная и понятная структура). | Среднее (много открывающих и закрывающих тегов). | Очень высокая (минимум пунктуации, акцент на отступлениях). |
| Размер и скорость парсинга | Компактный payload, быстрый парсинг в браузерах и серверах. | Больший объем текста из-за тегов, более тяжелый парсинг. | Компактный, но чувствительный к отступлениям и более сложный в парсинге. |
| Типизация и структуры | Объекты, массивы, строки, числа, булевые значения, null. |
Текстовые узлы, атрибуты, схемы валидации (XSD). | Словари, списки, скаляры, якоря и ссылки. |
| Типичные сценарии | REST / JSON API, веб-приложения, конфиги (package.json), поля в БД. |
SOAP, корпоративный документооборот, фиды/схемы данных. | Конфигурации CI/CD, Docker Compose, Kubernetes, Ansible. |
Практические примеры: структура JSON, JavaScript и PHP
Пример корректного JSON-документа
{
"service": "deploy-runner",
"version": 2,
"enabled": true,
"maintenanceWindow": null,
"targets": ["web-node-1", "web-node-2"],
"limits": {
"maxConcurrency": 4,
"timeoutSec": 30
}
}
Сериализация и парсинг в JavaScript
Для преобразования строки JSON в объект используется JSON.parse(), а для обратной сериализации объекта в строку JSON.stringify():
const rawResponse = '{"status":"ok","items":3}';
// Парсинг строки в JS-объект (обязательно оберните в try/catch для ненадежных данных)
try {
const data = JSON.parse(rawResponse);
console.log(data.items); // 3
} catch (err) {
console.error('Невалидный JSON:', err.message);
}
// Сериализация объекта в форматированную строку
const payload = { action: 'purge_cache', scope: ['css', 'js'] };
const jsonString = JSON.stringify(payload, null, 2);
Работа с JSON в PHP (json_encode и json_decode)
В PHP для кодирования и декодирования JSON рекомендуется передавать флажки безопасности и контроля ошибок (например, JSON_THROW_ON_ERROR и JSON_UNESCAPED_UNICODE):
<?php
$payload = [
'title' => 'Обновление конфигурации',
'active' => true,
'roles' => ['admin', 'editor'],
];
try {
$json = json_encode($payload, JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE);
$decoded = json_decode($json, true, 512, JSON_THROW_ON_ERROR);
echo $decoded['title']; // Обновление конфигурации
} catch (JsonException $e) {
error_log('Ошибка JSON: ' . $e->getMessage());
}
Технический совет разработчика: Никогда не доверяйте входящим JSON-данным без валидации и безопасного парсинга: в JavaScript вызов
JSON.parse()на поврежденной строке бросает исключениеSyntaxErrorи может остановить выполнение скрипта, если не обернуть его вtry...catch. Кроме того, если вы отдаете JSON через HTTP, всегда устанавливайте заголовокContent-Type: application/json; charset=utf-8, а в PHP при рендеринге данных внутри HTML используйтеJSON_HEX_TAG | JSON_HEX_AMP, чтобы избежать XSS-уязвимостей через последовательности</script>.