JSON в PHP

Похожие

О JSON to PHP классах и моделировании PHP сущностей

Варианты использования

• Разработка бэкенда Laravel: быстрое преобразование примера JSON из документации API в классы Eloquent Model / API Resource, сериализация ответов со встроенными интерфейсами Laravel Jsonable / Arrayable
• Интеграция Symfony Serializer: преобразование JSON, возвращаемого сторонними API, в PHP классы стиля ArrayObject, глубокое отображение объектов и валидация данных через Symfony Serializer
• WordPress REST API: преобразование JSON-структуры, возвращаемой пользовательскими endpoint, в PHP классы стиля stdClass, прямой вывод через wp_send_json(), соответствие поведению wp_json_encode() по умолчанию
• readonly DTO PHP 8.1+: преобразование JSON в final readonly class, использование как объекта передачи данных (DTO), обеспечение неизменяемости после создания, предотвращение случайного изменения данных ответа бизнес-логикой
• Разработка Composer-пакетов: преобразование JSON Schema в PHP классы, затем публикация на Packagist для использования как слой SDK моделей, другие проекты Composer могут подключать через require для повторного использования
• Фикстуры для юнит-тестов: преобразование JSON фикстур в PHP классы, затем выполнение тестов на основе тестовых данных через json_decode + десериализация, утверждение структурированных полей
• Скрипты миграции данных: преобразование JSON конфигурационных файлов в PHP классы, использование строготипизированного доступа в бизнес-логике, удобнее автодополнение IDE и проверка типов по сравнению с доступом к массивам
• Интеграция Mock на фронтенде: бэкенд сначала преобразует JSON-модель в PHP класс, фронтенд одновременно получает соответствующий интерфейс TypeScript / PHP класс, поддерживает согласованность типов с обеих сторон
• Ревью кода: преобразование JSON, возвращаемого API, в удобочитаемые PHP классы, облегчает обсуждение именования полей, видимости свойств при Code Review
• Рефакторинг устаревших проектов: рефакторинг кода на основе динамического доступа к ассоциативным массивам array в строготипизированный доступ на основе PHP классов, статический анализ с PHPStan / Psalm
• PHPUnit DataProvider: преобразование тестовых данных JSON в PHP классы, затем инъекция в тест-кейсы через DataProvider, IDE автоматически предлагает поля свойств
• Интеграция бэкенд API snake_case: когда бэкенд API возвращает поля snake_case, включите «Преобразовать в camelCase» + стиль ArrayObject в фронтенд PHP системе для плавной интеграции
• Статический анализ PHPStan: сгенерированные классы по умолчанию содержат объявления типов, можно использовать phpstan analyse ./src --level=8 в CI для блокировки ошибок типов
• Обучение и тренировка: в сценариях обучения PHP преобразование примера JSON в PHP классы для демонстрации объектно-ориентированного моделирования, системы типов, реализации интерфейсов
• Слой шлюза API Gateway: преобразование JSON, возвращаемого вышестоящими микросервисами, в PHP классы для агрегации на уровне шлюза, нижестоящие PHP сервисы строготипизированно потребляют через свойства классов
• Потребление очередей сообщений: преобразование тела JSON-сообщений, потребляемых из RabbitMQ / Kafka, в PHP классы, затем сохранение или пересылка, строгий разбор с JSON_THROW_ON_ERROR
• Моделирование SKU / SPU электронной коммерции: преобразование JSON-структуры товаров (много спецификаций / много изображений / много атрибутов) в PHP классы, оптимизация N+1 запросов в Laravel вместе со стилем ArrayObject
• Валидация WebHook callback: преобразование JSON-структуры валидации платёжных шлюзов, логистических callback в PHP классы, верификация подписи через hash_hmac()
• Инструментарий OpenAPI: преобразование schema JSON OpenAPI 3.x в PHP классы, подключение к потоку генерации PHP клиентов Swagger Codegen / Apifox
• ETL-пайплайны данных: преобразование JSON из вышестоящих источников данных (JSON-поля MySQL / MongoDB / Elasticsearch) в PHP классы, затем очистка и загрузка данных

Как использовать

1. Вставьте JSON объект (рекомендуется) или массив в левый редактор, или нажмите «Sample» для загрузки китайского примера с вложенными address / company / tags
2. Нажмите кнопку «Settings» на панели инструментов, выберите во всплывающем окне: ① Установите имя корневого класса (например: User) и namespace (например: App\Models); ② Выберите стиль кода (ArrayObject / stdClass / readonly class); ③ Выберите стиль кода (typed properties / Laravel интеграция / Symfony Serializer); ④ Выберите стратегию именования полей (сохранить оригинал / camelCase / все нижний регистр / UPPER_SNAKE)
3. Инструмент автоматически преобразует за 400 мс, справа отобразятся все сгенерированные PHP классы (каждый класс — независимый блок, заголовок отображает бейдж текущего стиля в реальном времени); при ошибке формата JSON отобразится кнопка «Исправить JSON»
4. Проверьте, соответствуют ли сгенерированные имена классов, имена свойств, интерфейсы ожидаемым; если требуется корректировка, измените имена ключей в исходном JSON или снова откройте Settings для изменения опций
5. Если устраивает, нажмите кнопку «Копировать» отдельного класса для вставки в IDE, или нажмите «Download ZIP» на панели инструментов для загрузки всех классов сразу (структура директорий по пути namespace)

Функции

• Два стиля кода, свободно переключаемые: ArrayObject (наследует \ArrayObject, поддерживает доступ в стиле массива $obj['key']) / stdClass (наследует \stdClass, поддерживает доступ в стиле объекта $obj->key), совместимы с различными сценариями, такими как сериализация Laravel, WordPress REST, Symfony Serializer
• Полный PHP шаблон: автоматически генерирует объявление namespace + use выражения + комментарий заголовка класса (Copyright + временная метка создания) + определение класса + типизированные public свойства (PHP 7.4+), можно напрямую подключать через require в проекты Composer без ручного написания шаблонного кода
• Автоматическая реализация интерфейса JsonSerializable: каждый класс автоматически генерирует public function jsonSerialize(): mixed { return [...] }, можно напрямую сериализовать в JSON с json_encode() без дополнительного шаблонного кода
• Опциональный readonly class PHP 8.1+: при включении сгенерированные классы получают final readonly class, все свойства становятся readonly, неизменяемы после создания, подходят для сценариев неизменяемых API response DTO
• Умный вывод типов: string → string, integer → int, float → float, bool → bool, array → array, вложенные объекты → независимые классы, null → ?type (nullable свойства), не нужно вручную указывать типы полей
• Автоматическое разделение вложенных классов: вложенные объекты используют имя поля с заглавной буквы для создания независимых PHP классов (например: address → Address), объекты в массивах именуются по правилу «удалить конечную s» (например: users → User), все вложенные классы также реализуют JsonSerializable
• 4 стратегии именования полей: сохранить оригинал / преобразовать snake_case в camelCase (user_name → userName) / все в нижнем регистре / UPPER_SNAKE константный стиль, соответствует стандартам кода PSR-1 / Laravel / Symfony
• Laravel интеграция в один клик: при выборе автоматически реализует интерфейсы Jsonable, Arrayable, добавляет методы toArray() / toJson(), можно напрямую использовать как Eloquent API Resource с автозагрузкой Composer
• Копирование одного класса + ZIP скачивание нескольких файлов: каждый PHP класс имеет независимую кнопку «Копировать», также можно нажать «Скачать ZIP» на панели инструментов для загрузки ZIP-пакета (например: App/Models/User.php) со структурой по namespace, распакуйте и используйте сразу
• Локальная работа в браузере + история: разбор JSON, генерация PHP классов, упаковка ZIP — всё выполняется в браузере на JavaScript (quicktype-core + JSZip), данные не загружаются ни на один сервер; встроенная localStorage история для последних 200 вводов

Примеры кода

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

// 模拟从 API 接收到的 JSON 字符串
$jsonString = '{"id":1,"name":"Alice","email":"alice@example.com","isActive":true}';

// 1) 反序列化为本工具生成的类
$userData = json_decode($jsonString, true);
$user = new User(
    $userData['id'],
    $userData['name'],
    $userData['email'],
    $userData['isActive']
);

// 2) 强类型访问字段（IDE 自动补全 + PHPStan 静态检查）
echo $user->name;          // Alice
echo $user->email;         // a****@***********example.com
echo $user->isActive ? '活跃' : '禁用'; // 活跃

// 3) json_encode() 自动调用 jsonSerialize()，无需任何额外代码
echo json_encode($user, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
/*
{
    "id": 1,
    "name": "Alice",
    "email": "alice@example.com",
    "isActive": true
}
*/

<?php

namespace App\Http\Controllers;

use App\Models\User;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;

class UserController extends Controller
{
    /**
     * GET /api/users/{id}
     */
    public function show(int $id): JsonResponse
    {
        // 1) 从数据库或外部 API 获取数据
        $userData = $this->fetchUserFromApi($id);

        // 2) 用本工具生成的 User 类包装
        $user = new User(
            $userData['id'],
            $userData['name'],
            $userData['email'],
            $userData['isActive']
        );

        // 3) 直接 return response()->json($user)
        //    Laravel 会自动调用 jsonSerialize()
        return response()->json($user);
    }

    /**
     * POST /api/users
     */
    public function store(Request $request): JsonResponse
    {
        // 4) 反向用法：把请求 JSON 反序列化为 User 类
        $user = User::fromArray($request->all());

        // 5) 用 toArray() 获取数组形式
        $payload = $user->toArray();

        // 6) 执行业务逻辑（如入库 / 调用第三方 API）
        $this->userService->create($payload);

        return response()->json([
            'message' => 'User created',
            'data' => $user,
        ], 201);
    }
}

/*
 * 对应 composer.json 依赖：
 * "require": {
 *     "php": "^8.1",
 *     "laravel/framework": "^11.0"
 * }
 */

<?php

namespace App\Service;

use App\Models\User;
use Symfony\Component\Serializer\SerializerInterface;
use Symfony\Component\Serializer\Normalizer\PropertyNormalizer;

class UserSerializer
{
    private SerializerInterface $serializer;

    public function __construct(SerializerInterface $serializer)
    {
        // 使用 PropertyNormalizer 处理 public 属性
        $this->serializer = $serializer;
    }

    /**
     * 将 User 对象序列化为 JSON 字符串
     */
    public function toJson(User $user): string
    {
        return $this->serializer->serialize($user, 'json');
    }

    /**
     * 将 JSON 字符串反序列化为 User 对象
     */
    public function fromJson(string $json): User
    {
        return $this->serializer->deserialize($json, User::class, 'json');
    }

    /**
     * 批量反序列化（如从 MongoDB 导出的 JSON 数组）
     */
    public function fromJsonArray(string $jsonArray): array
    {
        $users = [];
        $data = json_decode($jsonArray, true);

        foreach ($data as $item) {
            $users[] = User::fromArray($item);
        }

        return $users;
    }
}

// 使用示例
$serializer = new UserSerializer($serializerService);

$json = '{"id":1,"name":"Alice","address":{"city":"Beijing","zip":"100000"},"tags":["php","symfony"]}';

// 反序列化为本工具生成的 User 对象
$user = $serializer->fromJson($json);
echo $user->name;                  // Alice
echo $user->address->city;         // Beijing (强类型访问)
print_r($user->tags);              // ['php', 'symfony']

// 序列化回 JSON
$jsonOutput = $serializer->toJson($user);

Best Practices

Часто задаваемые вопросы

Устранение неполадок

Глоссарий

namespace

Механизм пространств имён, введённый в PHP 5.3+ для предотвращения конфликтов имён классов. Этот инструмент автоматически генерирует согласно установленному пользователем namespace и организует директории App/Models/ в ZIP.

class

Шаблон для определения объектов в PHP. То, что создаёт этот инструмент — стандартные PHP class, можно напрямую инстанцировать через new User(...).

ArrayObject

Класс стандартной библиотеки PHP SPL, реализующий интерфейсы как ArrayAccess. Классы, сгенерированные в стиле ArrayObject этим инструментом, наследуют \ArrayObject, поддерживают двойной доступ в стиле массива и объекта.

stdClass

Встроенный универсальный класс объектов PHP, json_decode($json, false) по умолчанию возвращает этот тип. Классы, сгенерированные в стиле stdClass этим инструментом, наследуют \stdClass, поддерживают только доступ в стиле объекта.

typed properties

Объявления типов свойств, введённые в PHP 7.4+ (например: public int $id). Свойства, генерируемые этим инструментом, по умолчанию содержат объявления типов, позволяя IDE и инструментам статического анализа напрямую проверять типы.

readonly class

Классы только для чтения, введённые в PHP 8.1+, все свойства в классе автоматически становятся readonly и не могут быть изменены после создания. Стиль readonly этого инструмента создаёт final readonly class, подходит для сценариев неизменяемых DTO.

JsonSerializable

Интерфейс, введённый в PHP 5.4+, объекты, реализующие этот интерфейс, автоматически вызывают метод jsonSerialize() при обработке json_encode(). Все классы этого инструмента автоматически реализуют этот интерфейс.

Jsonable (Laravel)

Контрактный интерфейс фреймворка Laravel, после реализации объект может вызывать toJson() для вывода JSON. Стиль Laravel интеграции этого инструмента автоматически реализует этот интерфейс.

Arrayable (Laravel)

Контрактный интерфейс фреймворка Laravel, после реализации объект может вызывать toArray() для вывода массива. Стиль Laravel интеграции этого инструмента автоматически реализует этот интерфейс.

Composer

Официальный инструмент управления зависимостями PHP. При использовании кода, сгенерированного этим инструментом, нужно настроить PSR-4 автозагрузку в composer.json (например: App\\: src/).

PSR-4

Стандарт автозагрузки, принятый PHP-FIG, загружает файлы классов через сопоставление пространство имён — директория. ZIP-пакеты, генерируемые этим инструментом, структурированы по пути пространства имён и соответствуют стандарту PSR-4.

Symfony Serializer

Фреймворк сериализации компонента Symfony. Классы, сгенерированные в стиле ArrayObject этим инструментом, могут использоваться с PropertyNormalizer Symfony Serializer для глубокой сериализации и десериализации.

Eloquent API Resource

Класс API ресурсов Laravel Eloquent, используется для форматирования API ответов. Классы, сгенерированные в стиле Laravel интеграции этим инструментом, могут напрямую использоваться как базовые классы API Resource.

composer.json

Файл конфигурации проекта Composer. После помещения кода, сгенерированного этим инструментом, в директорию src нужно настроить секцию autoload в composer.json и выполнить composer dump-autoload.

json_encode / json_decode

Встроенные функции PHP для сериализации и десериализации JSON. После реализации классом, сгенерированным этим инструментом, JsonSerializable, json_encode() автоматически вызывает метод jsonSerialize().

PHPUnit DataProvider

Механизм поставщиков данных фреймворка тестирования PHPUnit. PHP классы, сгенерированные этим инструментом, могут инъецироваться в тест-кейсы через DataProvider, повышая эффективность написания тестов с автодополнением IDE.

PHPStan

Инструмент статического анализа PHP, может проверять типы кода, обнаруживать ошибки. Классы, сгенерированные этим инструментом, имеют typed properties, поэтому могут полностью выводить типы свойств в режиме PHPStan --level=8.

Psalm

Ещё один инструмент статического анализа PHP с открытым исходным кодом от Vimeo. Классы, сгенерированные этим инструментом, могут выполнять строгую проверку типов с PropertyTypeProvider Psalm.

Doctrine

Набор инструментов ORM и DBAL в экосистеме PHP. PHP классы, сгенерированные этим инструментом, могут использоваться как основа для Doctrine Entity, затем вручную добавлять аннотации типа #[ORM\Column].

php -l

Команда проверки синтаксиса в командной строке PHP. Классы, сгенерированные этим инструментом, можно сначала проверить на синтаксис через php -l User.php, затем подключать в проект.

Composer dump-autoload

Команда Composer для пересоздания индекса автозагрузки. После помещения классов, сгенерированных этим инструментом, в директорию src нужно выполнить composer dump-autoload, чтобы PSR-4 автозагрузка их распознала.

JSON_THROW_ON_ERROR

Флаг обработки ошибок json_decode() в PHP 7.3+, при включении выбрасывает исключение JsonException при неудачном разборе JSON. Пример Laravel этого инструмента использует строгий разбор.

Hash (PHP)

Встроенная хеш-функция PHP, в основном используется для валидации WebHook. Классы WebHook callback, сгенерированные этим инструментом, используются для верификации подписи вместе с hash_hmac().

Быстрая таблица соответствия типов JSON типам PHP

Этот инструмент автоматически выводит соответствующие типы PHP по типу значения JSON; общие отношения сопоставления:

Таблица сравнения 4 стилей кода PHP

4 стиля кода PHP классов, поддерживаемые инструментом, выбирайте согласно требованиям проекта:

Privacy & Security

Все операции разбора JSON, генерации PHP классов, упаковки ZIP этого инструмента JSON to PHP выполняются полностью локально в вашем браузере на JavaScript (quicktype-core + JSZip); введённые JSON данные и сгенерированный PHP код не загружаются ни на один сервер, не записываются, не кэшируются и не сохраняются в облаке. Можно смело использовать даже для чувствительного JSON с полями внутренних интерфейсов, неопубликованными бизнес-структурами, нераскрытыми API ответами, все данные удаляются при закрытии страницы. Этот инструмент не использует никакие cookie для отслеживания пользователей, не собирает email или информацию об аккаунтах, не встраивает сторонние аналитические скрипты, все вычисления выполняются в процессе браузера текущего устройства. Даже в офлайн-среде (например, сетевое подключение разорвано или среда изолированной интрасети) можно нормально использовать после однократной загрузки ресурсов страницы.

Authoritative References

• PHP.netОфициальная документация PHP - Классы и объекты
• PHP.netОфициальная документация PHP - Интерфейс JsonSerializable
• PHP.netОфициальная документация PHP - Модификатор Readonly (PHP 8.1+)
• PHP.netОфициальная документация PHP - Typed Properties (PHP 7.4+)
• PHP-FIGСтандарт автозагрузки PSR-4
• LaravelОфициальная документация Laravel - Eloquent: API Resources
• SymfonyДокументация компонента Symfony Serializer
• ComposerОфициальная документация Composer - PSR-4 Autoload