JSON a PHP

Relacionado

Acerca de JSON a clase PHP y modelado de clases de entidad PHP

Casos de uso

• Desarrollo backend Laravel: convierte rápidamente JSON de ejemplo de documentación de interfaz API a clases Eloquent Model / API Resource, serializa respuestas directamente con interfaces Jsonable / Arrayable integradas de Laravel
• Integración Symfony Serializer: convierte JSON devuelto por API de terceros a clases PHP estilo ArrayObject, realiza mapeo de objetos profundo y validación de datos con Symfony Serializer
• WordPress REST API: convierte estructura JSON devuelta por endpoint personalizado a clases PHP estilo stdClass, envía directamente con wp_send_json(), coincide con comportamiento predeterminado wp_json_encode()
• DTO readonly PHP 8.1+: convierte JSON a final readonly class para objetos de transferencia de datos (DTO), inmutables después de construcción, evita que lógica de negocio modifique por error datos de respuesta
• Desarrollo de paquetes Composer: convierte JSON Schema a clases PHP y publica en Packagist como capa de modelos SDK, para que otros proyectos Composer lo requieran y reutilicen
• Fixtures de pruebas unitarias: convierte fixtures JSON a clases PHP y realiza pruebas basadas en datos con json_decode + deserialización, afirma campos estructurados
• Scripts de migración de datos: convierte archivos de configuración JSON a clases PHP para acceso fuertemente tipado en lógica de negocio, más fácil autocompletado IDE y verificación de tipos que acceso array
• Integración Mock frontend: backend convierte primero modelos JSON a clases PHP, frontend obtiene al mismo tiempo la interfaz TypeScript / clase PHP correspondiente, mantiene coherencia de tipos entre ambos extremos
• Revisión de código: convierte directamente JSON devuelto por API a clases PHP legibles, facilita discutir nomenclatura de campos, visibilidad de propiedades durante Code Review
• Refactorización de proyectos antiguos: refactoriza código de acceso dinámico basado en array asociativo a acceso fuertemente tipado basado en clase PHP, realiza análisis estático con PHPStan / Psalm
• Proveedor de datos PHPUnit: convierte datos de prueba JSON a clases PHP y los inyecta en casos de prueba mediante DataProvider, el IDE sugiere automáticamente campos de propiedad
• Integración de API backend snake_case: API backend devuelve campos snake_case, el sistema PHP frontend activa estilo 'Convertir a camelCase' + ArrayObject para integración perfecta
• Análisis estático PHPStan: las clases generadas tienen naturalmente declaraciones de tipos, se puede usar phpstan analyse ./src --level=8 para interceptar errores de tipos en CI
• Enseñanza y capacitación: en escenarios de enseñanza PHP, convierte JSON de ejemplo a clases PHP para demostrar modelado orientado a objetos, sistema de tipos, implementación de interfaces
• Capa de puerta de enlace API Gateway: convierte JSON devuelto por microservicios ascendentes a clases PHP para agregación en capa de puerta de enlace, servicios PHP descendientes consumen fuertemente tipados por propiedades de clase
• Consumo de colas de mensajes: convierte cuerpos de mensajes JSON consumidos de RabbitMQ / Kafka a clases PHP para almacenar o reenviar, realiza análisis estricto con JSON_THROW_ON_ERROR
• Modelado SKU / SPU de comercio electrónico: convierte estructura JSON de productos (múltiples especificaciones / múltiples imágenes / múltiples atributos) a clases PHP, acompaña estilo ArrayObject para optimización de consultas N+1 en Laravel
• Verificación de firma WebHook: convierte estructura de verificación de firma JSON de devoluciones de llamadas de pasarelas de pago, logística a clases PHP, realiza verificación de firma con hash_hmac()
• Cadena de herramientas OpenAPI: convierte schema JSON de OpenAPI 3.x a clases PHP, se conecta al flujo de generación de cliente PHP de Swagger Codegen / Apifox
• Tubería ETL de datos: convierte JSON de fuentes de datos ascendentes (campos JSON MySQL / MongoDB / Elasticsearch) a clases PHP y luego realiza limpieza de datos y almacenamiento

Cómo Usar

1. Pega un objeto JSON (recomendado) o array en el editor izquierdo, o haz clic en 'Sample' para cargar ejemplo en chino (con address / company / tags anidados)
2. Haz clic en el botón 'Settings' en la barra de herramientas, selecciona en el popup: ① establece nombre de clase raíz (como User) y namespace (como App\Models); ② selecciona estilo de código (ArrayObject / stdClass / readonly class); ③ selecciona estilo de código (propiedades tipadas / integración Laravel / Symfony Serializer); ④ selecciona estrategia de nomenclatura de campos (mantener original / camelCase / todo minúsculas / UPPER_SNAKE)
3. La herramienta se convertirá automáticamente en 400 ms, a la derecha se muestran todas las clases PHP generadas (cada clase una tarjeta independiente, la barra de título muestra insignia de estilo actual en tiempo real); si JSON tiene errores de formato se mostrará botón 'Reparar JSON'
4. Verifica que los nombres de clase, nombres de propiedad e interfaces generados cumplan las expectativas; si necesitas ajustes puedes modificar nombres de clave del JSON fuente o volver a abrir Settings para modificar opciones
5. Después de estar satisfecho, puedes hacer clic en el botón 'Copiar' de una clase individual para pegar en IDE, o hacer clic en 'Download ZIP' en la barra de herramientas para descargar todas las clases con un clic (organizadas por ruta namespace en estructura de directorios)

Características

• Dos estilos de código conmutables libremente: ArrayObject (extiende \ArrayObject, admite acceso tipo array $obj['key']) / stdClass (extiende \stdClass, admite acceso tipo objeto $obj->key), compatible con serialización Laravel, WordPress REST, Symfony Serializer y otros escenarios
• Plantilla PHP completa: genera automáticamente declaración namespace + sentencias use + comentario de encabezado de clase (Copyright + marca de tiempo de generación) + definición de clase + propiedades públicas tipadas (PHP 7.4+), se puede requerir directamente en proyecto Composer sin código repetitivo manual
• Interfaz JsonSerializable implementada automáticamente: cada clase genera automáticamente public function jsonSerialize(): mixed { return [...] }, serializa JSON directamente con json_encode(), cero código repetitivo adicional
• Clase readonly PHP 8.1+ opcional: al activarse, la clase generada añade final readonly class, todas las propiedades son readonly, inmutables después de la construcción, adecuada para escenarios DTO de respuesta API inmutables
• Inferencia de tipos inteligente: string → string, integer → int, float → float, bool → bool, array → array, objetos anidados → clase independiente, null → ?type (propiedad nullable), no se necesita especificación manual de tipos de campo
• Clases anidadas divididas automáticamente: objetos anidados generan clases PHP independientes con nombres de campo capitalizados (ej. address → Address), objetos en arrays nombrados por regla 'eliminar s final' (ej. users → User), todas las clases anidadas también implementan JsonSerializable
• 4 estrategias de nomenclatura de campos: mantener original / snake_case a camelCase (user_name → userName) / todo minúsculas / estilo constante UPPER_SNAKE, coincidiendo con convenciones de código PSR-1 / Laravel / Symfony
• Integración Laravel con un clic: al marcar, implementa automáticamente interfaces Jsonable, Arrayable, añade métodos toArray() / toJson(), se puede usar directamente como Eloquent API Resource con carga automática Composer
• Copiar clase individual + descarga multiarchivo ZIP: cada clase PHP tiene botón 'Copiar' independiente, descarga con un clic de paquete ZIP organizado por estructura de directorios namespace (ej. App/Models/User.php), descomprime y usa
• Ejecución local en navegador + historial: análisis JSON, generación de clases PHP, empaquetado ZIP todo completado en el navegador mediante JavaScript (quicktype-core + JSZip), datos no subidos a ningún servidor; historial localStorage integrado para últimas 200 entradas

Ejemplos de Código

<?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****@***********
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

Preguntas Frecuentes

Solución de problemas

Glosario

namespace

Mecanismo de espacios de nombres introducido en PHP 5.3+, evita conflictos de nombres de clase. Esta herramienta genera automáticamente según el namespace establecido por el usuario y organiza en ZIP por directorio App/Models/.

class

Plantilla para definir objetos en PHP. Esta herramienta genera clases PHP estándar que se pueden instanciar directamente con new User(...).

ArrayObject

Clase en la biblioteca estándar SPL de PHP, implementa interfaces como ArrayAccess. Las clases generadas en estilo ArrayObject de esta herramienta heredan de \ArrayObject, admiten acceso dual tipo array y tipo objeto.

stdClass

Clase de objeto genérico integrada de PHP, json_decode($json, false) devuelve este tipo por defecto. Las clases generadas en estilo stdClass de esta herramienta heredan de \stdClass, solo admiten acceso tipo objeto.

typed properties

Declaración de tipos de propiedades introducida en PHP 7.4+ (como public int $id). Las propiedades generadas por esta herramienta tienen declaraciones de tipos por defecto, IDE y herramientas de análisis estático pueden realizar verificación de tipos directamente.

readonly class

Clase de solo lectura introducida en PHP 8.1+, todas las propiedades dentro de la clase son automáticamente readonly, no modificables después de construcción. El estilo readonly de esta herramienta genera final readonly class, adecuado para escenarios DTO inmutables.

JsonSerializable

Interfaz introducida en PHP 5.4+, los objetos que implementan esta interfaz llamarán automáticamente al método jsonSerialize() al ser procesados por json_encode(). Todas las clases de esta herramienta implementan automáticamente esta interfaz.

Jsonable (Laravel)

Interfaz de contrato del framework Laravel, después de implementarla el objeto puede llamar a toJson() para generar JSON. El estilo de integración Laravel de esta herramienta implementa automáticamente esta interfaz.

Arrayable (Laravel)

Interfaz de contrato del framework Laravel, después de implementarla el objeto puede llamar a toArray() para generar array. El estilo de integración Laravel de esta herramienta implementa automáticamente esta interfaz.

Composer

Herramienta oficial de gestión de dependencias de PHP. Al usar código generado por esta herramienta, necesitas configurar carga automática PSR-4 en composer.json (como App\\: src/).

PSR-4

Especificación de carga automática formulada por PHP-FIG, carga archivos de clase según mapeo de espacio de nombres a directorio. El paquete ZIP generado por esta herramienta se organiza por ruta namespace, cumple con la especificación PSR-4.

Symfony Serializer

Framework de serialización del componente Symfony. Las clases generadas en estilo ArrayObject de esta herramienta pueden acompañar PropertyNormalizer de Symfony Serializer para serialización y deserialización profunda.

Eloquent API Resource

Clase de recursos API de Laravel Eloquent, para formatear respuestas API. Las clases generadas en estilo integración Laravel de esta herramienta se pueden usar directamente como clase base de API Resource.

composer.json

Archivo de configuración de proyecto Composer. Después de colocar el código generado por esta herramienta en el directorio src, necesitas configurar la sección autoload en composer.json y ejecutar composer dump-autoload.

json_encode / json_decode

Funciones integradas de PHP para serialización y deserialización JSON. Después de que las clases generadas por esta herramienta implementen JsonSerializable, json_encode() llamará automáticamente al método jsonSerialize().

PHPUnit DataProvider

Mecanismo de proveedor de datos del framework de pruebas PHPUnit. Las clases PHP generadas por esta herramienta se pueden inyectar como DataProvider en casos de prueba, acompañando autocompletado IDE para mejorar eficiencia de escritura de pruebas.

PHPStan

Herramienta de análisis estático de PHP, puede realizar verificación de tipos, detección de errores en código. Debido a que las clases generadas por esta herramienta tienen typed properties, PHPStan puede inferir completamente tipos de propiedades en modo --level=8.

Psalm

Otra herramienta de análisis estático PHP, de código abierto por Vimeo. Las clases generadas por esta herramienta acompañando PropertyTypeProvider de Psalm pueden realizar verificación de tipos fuerte.

Doctrine

Conjunto de herramientas ORM y DBAL del ecosistema PHP. Las clases PHP generadas por esta herramienta pueden usarse como esqueleto de Doctrine Entity, luego añadir manualmente anotaciones como #[ORM\Column].

php -l

Instrucción de verificación de sintaxis de línea de comandos PHP. Las clases generadas por esta herramienta pueden ejecutar primero php -l User.php para verificación de sintaxis, luego requerir en el proyecto.

Composer dump-autoload

Comando de Composer para regenerar índice de carga automática. Después de colocar las clases generadas por esta herramienta en el directorio src, se debe ejecutar composer dump-autoload para que PSR-4 las reconozca para carga automática.

JSON_THROW_ON_ERROR

Indicador de manejo de errores de json_decode() en PHP 7.3+, al activarse un análisis JSON fallido lanzará excepción JsonException. El ejemplo Laravel de esta herramienta usa análisis estricto.

Hash (PHP)

Función hash integrada de PHP, comúnmente usada para verificación de firma WebHook. Las clases de devolución de llamada WebHook generadas por esta herramienta acompañan hash_hmac() para verificación de firma.

Tabla de referencia rápida de mapeo de tipos JSON a tipos PHP

Esta herramienta infiere automáticamente el tipo PHP correspondiente según el tipo de valor JSON; las relaciones de mapeo comunes son las siguientes:

Tabla comparativa de 4 estilos de código PHP

4 estilos de código de clase PHP admitidos por la herramienta, elige según necesidades del proyecto:

Privacy & Security

Todas las operaciones de análisis JSON, generación de clases PHP, empaquetado ZIP de esta herramienta JSON a PHP se completan completamente localmente en tu navegador mediante JavaScript (quicktype-core + JSZip); los datos JSON de entrada y el código PHP generado no se suben a ningún servidor, ni se registran, almacenan en caché o almacenan en la nube. JSON sensible que contiene campos de interfaz interna, estructuras de negocio no lanzadas, respuestas API no públicas se puede usar con confianza, todos los datos se borran al cerrar la página. Esta herramienta no usa ninguna Cookie para seguimiento de usuarios, no recopila información de correo electrónico o cuenta, no incrusta ningún script de estadísticas de terceros, todos los cálculos se completan en el proceso del navegador del dispositivo actual. Incluso en entorno sin conexión (como red desconectada o entorno aislado de red interna), siempre que la página haya cargado recursos una vez se puede usar normalmente.

Authoritative References

• PHP.netDocumentación oficial PHP - Clases y objetos
• PHP.netDocumentación oficial PHP - Interfaz JsonSerializable
• PHP.netDocumentación oficial PHP - Modificador Readonly (PHP 8.1+)
• PHP.netDocumentación oficial PHP - Propiedades tipadas (PHP 7.4+)
• PHP-FIGEspecificación de carga automática PSR-4
• LaravelDocumentación oficial Laravel - Eloquent: API Resources
• SymfonyDocumentación del componente Symfony Serializer
• ComposerDocumentación oficial Composer - Carga automática PSR-4