JSON para PHP

Sugestões Relacionadas

Sobre JSON para classe PHP e modelagem de classes de entidade PHP

Casos de uso

• Desenvolvimento backend Laravel: converter rapidamente JSON de exemplo da documentação de interface API em classes Eloquent Model / API Resource, serializar respostas diretamente com interfaces Jsonable / Arrayable integradas do Laravel
• Integração Symfony Serializer: converter JSON retornado por APIs de terceiros em classes PHP estilo ArrayObject, fazer mapeamento profundo de objetos e validação de dados com Symfony Serializer
• WordPress REST API: converter estrutura JSON retornada por endpoints personalizados em classes PHP estilo stdClass, saída direta com wp_send_json(), compatível com o comportamento padrão de wp_json_encode()
• PHP 8.1+ readonly DTO: converter JSON em final readonly class para Data Transfer Object (DTO), imutáveis após construção, evitando que a lógica de negócio modifique acidentalmente os dados de resposta
• Desenvolvimento de pacotes Composer: converter JSON Schema em classes PHP então publicar no Packagist como camada de modelo SDK, para que outros projetos Composer o requeiram e reutilizem
• Fixture de testes unitários: converter fixture JSON em classes PHP então usar json_decode + desserialização para testes baseados em dados, assertion de campos estruturados
• Scripts de migração de dados: converter arquivos de configuração JSON em classes PHP então usá-las para acesso fortemente tipado na lógica de negócio, mais fácil autocompletar IDE e verificação de tipos do que acesso array
• Integração Frontend Mock: backend converte primeiro modelos JSON em classes PHP, frontend obtém simultaneamente a interface TypeScript / classe PHP correspondente, mantendo os tipos consistentes em ambas as extremidades
• Code review: converter JSON retornado por API diretamente em classes PHP legíveis, facilitando discussão sobre nomenclatura de campos, visibilidade de propriedades durante Code Review
• Refatoração de projetos legados: refatorar código de acesso dinâmico baseado em array associativo em acesso fortemente tipado baseado em classe PHP, fazer análise estática com PHPStan / Psalm
• PHPUnit DataProvider: converter dados de teste JSON em classes PHP então injetar no caso de teste via DataProvider, o IDE sugere automaticamente os campos das propriedades
• Integração API backend snake_case: API backend retorna campos snake_case, o sistema PHP frontend ativa 'converter para camelCase' + estilo ArrayObject para integração transparente
• Análise estática PHPStan: as classes geradas têm naturalmente declarações de tipo, com phpstan analyse --level=8 interceptar erros de tipo em CI
• Ensino e formação: em cenários de ensino PHP, converter JSON de exemplo em classes PHP para demonstrar modelagem orientada a objetos, sistema de tipos, implementação de interfaces
• Camada gateway API: converter JSON retornado por microsserviços a montante em classes PHP para agregação na camada gateway, os serviços PHP a jusante consomem fortemente tipados via propriedades de classe
• Consumo de filas de mensagens: converter corpos de mensagens JSON consumidos de RabbitMQ / Kafka em classes PHP então armazenar ou reenviar, análise rigorosa com JSON_THROW_ON_ERROR
• Modelagem SKU/SPU e-commerce: converter estrutura JSON de produto (multi-especificação / multi-imagem / multi-atributo) em classes PHP, com estilo ArrayObject fazer otimização de consultas N+1 no Laravel
• Verificação de assinatura de callback WebHook: converter estrutura de verificação de assinatura JSON de gateways de pagamento, callbacks logísticos em classes PHP, verificação de assinatura com hash_hmac()
• Toolchain OpenAPI: converter schema JSON do OpenAPI 3.x em classes PHP, integrar com fluxo de geração de cliente PHP do Swagger Codegen / Apifox
• Pipeline ETL de dados: converter JSON de fontes de dados a montante (campo JSON MySQL / MongoDB / Elasticsearch) em classes PHP então limpeza de dados e armazenamento

Como Usar

1. Cole objeto JSON (recomendado) ou array no editor à esquerda, ou clique em 'Sample' para carregar exemplo em chinês (com address / company / tags aninhados)
2. Clique no botão 'Configurações' na barra de ferramentas, na caixa de diálogo selecione: ① defina nome da classe raiz (ex. User) e namespace (ex. App\Models); ② selecione estilo de código (ArrayObject / stdClass / readonly class); ③ selecione funcionalidades de código (typed properties / integração Laravel / Symfony Serializer); ④ selecione estratégia de nomenclatura de campos (manter original / camelCase / tudo minúsculas / UPPER_SNAKE)
3. A ferramenta converterá automaticamente em 400ms, a direita mostra todas as classes PHP geradas (cada classe um card separado, a barra de título mostra badge de estilo atual em tempo real); se JSON tiver erros de formato será exibido botão 'Reparar JSON'
4. Verifique que nomes de classe gerados, nomes de propriedades e interfaces atendam às expectativas; se for necessário adaptação você pode modificar os nomes das chaves do JSON de origem ou reabrir Configurações para modificar as opções
5. Quando satisfeito pode clicar no botão 'Copiar' da classe individual para colar no IDE, ou clicar em 'Download ZIP' na barra de ferramentas para baixar todas as classes em um clique (estrutura de diretórios organizada por caminho namespace)

Recursos

• Dois estilos de código livremente alternáveis: ArrayObject (estende \ArrayObject, suporta acesso estilo array $obj['key']) / stdClass (estende \stdClass, suporta acesso estilo objeto $obj->key), compatível com diferentes cenários como serialização Laravel, WordPress REST, Symfony Serializer
• Template PHP completo: gera automaticamente declaração namespace + instruções use + comentário de cabeçalho de classe (Copyright + timestamp de geração) + definição de classe + propriedades públicas tipadas (PHP 7.4+), pode ser incluído diretamente em projeto Composer via require sem completar manualmente o boilerplate
• Interface JsonSerializable implementada automaticamente: cada classe gerada cria automaticamente public function jsonSerialize(): mixed { return [...] }, serializa JSON diretamente com json_encode(), zero código boilerplate adicional
• readonly class PHP 8.1+ opcional: ao ativar, a classe gerada adiciona final readonly class, todas as propriedades são readonly, imutáveis após construção, adequado para cenários DTO de resposta API imutáveis
• Inferência de tipos inteligente: string → string, integer → int, float → float, bool → bool, array → array, objetos aninhados → classe independente, null → ?type (propriedade nullable), sem especificação manual de tipos de campo
• Classes aninhadas divididas automaticamente: objetos aninhados geram classes PHP independentes com primeira letra do nome do campo em maiúscula (ex. address → Address), objetos em arrays nomeados segundo regra 'remover s final' (ex. users → User), todas as classes aninhadas também implementam JsonSerializable
• 4 estratégias de nomenclatura de campos: manter original / snake_case para camelCase (user_name → userName) / tudo minúsculas / estilo constantes UPPER_SNAKE, conformes a diferentes padrões de codificação PSR-1 / Laravel / Symfony
• Integração Laravel em um clique: ao ativar, implementa automaticamente interfaces Jsonable, Arrayable, adiciona métodos toArray() / toJson(), pode ser usado diretamente como Eloquent API Resource, com autoload Composer
• Copiar classe individual + download ZIP multi-arquivo: cada classe PHP tem botão 'Copiar' separado, pode baixar em um clique pacote ZIP organizado por estrutura de diretórios namespace (ex. App/Models/User.php), descompactar e usar
• Execução local no navegador + histórico: análise JSON, geração de classes PHP, empacotamento ZIP via JavaScript (quicktype-core + JSZip) no navegador, dados não enviados para servidor; histórico localStorage integrado para 200 entradas recentes

Exemplos de Código

<?php

require_once 'vendor/autoload.php';

use App\Models\User;

// Simula string JSON recebida de API
$jsonString = '{"id":1,"name":"Alice","email":"a****@***********","isActive":true}';

// 1) Desserializa em classe gerada por esta ferramenta
$userData = json_decode($jsonString, true);
$user = new User(
    $userData['id'],
    $userData['name'],
    $userData['email'],
    $userData['isActive']
);

// 2) Acesso aos campos fortemente tipado (autocompletar IDE + verificação estática PHPStan)
echo $user->name;          // Alice
echo $user->email;         // a****@***********
echo $user->isActive ? 'Ativo' : 'Inativo'; // Ativo

// 3) json_encode() chama automaticamente jsonSerialize(), nenhum código adicional necessário
echo json_encode($user, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
/*
{
    "id": 1,
    "name": "Alice",
    "email": "a****@***********",
    "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

Perguntas frequentes

Solução de Problemas

Glossário

namespace

Mecanismo de namespaces introduzido no PHP 5.3+ para evitar conflitos de nomes de classe. Esta ferramenta gera automaticamente conforme namespace configurado pelo usuário e organiza no ZIP por diretório App/Models/.

class

Modelo que define objetos no PHP. Esta ferramenta gera class PHP padrão, instanciável diretamente via new User(...).

ArrayObject

Classe na biblioteca padrão SPL do PHP que implementa interfaces como ArrayAccess. As classes geradas em estilo ArrayObject por esta ferramenta herdam de \ArrayObject, suportando acesso duplo estilo array e objeto.

stdClass

Classe de objeto genérica integrada do PHP; json_decode($json, false) retorna este tipo por padrão. As classes geradas em estilo stdClass por esta ferramenta herdam de \stdClass, suportam apenas acesso estilo objeto.

typed properties

Declarações de tipo de propriedade introduzidas no PHP 7.4+ (ex. public int $id). As propriedades geradas por esta ferramenta têm declarações de tipo por padrão; o IDE e ferramentas de análise estática podem fazer verificação de tipos diretamente.

readonly class

Classe somente leitura introduzida no PHP 8.1+; todas as propriedades na classe são automaticamente readonly, não modificáveis após construção. Esta ferramenta gera final readonly class em estilo readonly, adequado para cenários DTO imutáveis.

JsonSerializable

Interface introduzida no PHP 5.4+; objetos que implementam esta interface chamam automaticamente o método jsonSerialize() durante json_encode(). Todas as classes desta ferramenta implementam automaticamente esta interface.

Jsonable (Laravel)

Interface de contrato do framework Laravel; após implementação, o objeto pode chamar toJson() para retornar JSON. O estilo integração Laravel desta ferramenta implementa automaticamente esta interface.

Arrayable (Laravel)

Interface de contrato do framework Laravel; após implementação, o objeto pode chamar toArray() para retornar array. O estilo integração Laravel desta ferramenta implementa automaticamente esta interface.

Composer

Ferramenta oficial de gerenciamento de dependências do PHP. Ao usar o código gerado por esta ferramenta, é necessário configurar autoload PSR-4 em composer.json (ex. App\\: src/).

PSR-4

Padrão de autoload especificado pelo PHP-FIG, que carrega arquivos de classe via mapeamento namespace para diretório. O pacote ZIP gerado por esta ferramenta é organizado por caminho namespace, compatível com o padrão PSR-4.

Symfony Serializer

Framework de serialização do componente Symfony. As classes geradas em estilo ArrayObject por esta ferramenta podem colaborar com PropertyNormalizer do Symfony Serializer para serialização e desserialização profundas.

Eloquent API Resource

Classe de recursos API do Laravel Eloquent, usada para formatar respostas API. As classes geradas em estilo integração Laravel por esta ferramenta podem ser usadas diretamente como classes base API Resource.

composer.json

Arquivo de configuração do projeto Composer. Após colocar o código gerado por esta ferramenta no diretório src, é necessário configurar seção autoload em composer.json e executar composer dump-autoload.

json_encode / json_decode

Funções integradas de serialização e desserialização JSON do PHP. Após classes geradas por esta ferramenta implementarem JsonSerializable, json_encode() chama automaticamente o método jsonSerialize().

PHPUnit DataProvider

Mecanismo de provedor de dados do framework de testes PHPUnit. As classes PHP geradas por esta ferramenta podem ser injetadas no caso de teste como DataProvider, melhorando a eficiência de escrita de testes com autocompletar IDE.

PHPStan

Ferramenta de análise estática para PHP, pode fazer verificação de tipos, detecção de erros no código. As classes geradas por esta ferramenta, tendo typed properties, podem ter tipos de propriedade completamente inferidos pelo PHPStan no modo --level=8.

Psalm

Outra ferramenta de análise estática para PHP, open-source da Vimeo. As classes geradas por esta ferramenta, com PropertyTypeProvider do Psalm, podem fazer validação de tipos forte.

Doctrine

Conjunto de ferramentas ORM e DBAL no ecossistema PHP. As classes PHP geradas por esta ferramenta podem servir de esqueleto para Doctrine Entity, então adicionar manualmente anotações como #[ORM\Column].

php -l

Diretiva de verificação de sintaxe na linha de comando PHP. As classes geradas por esta ferramenta podem primeiro executar php -l User.php para validação de sintaxe antes de require no projeto.

Composer dump-autoload

Comando para fazer Composer regenerar índice de autoload. Após colocar as classes geradas por esta ferramenta no diretório src, é necessário executar composer dump-autoload para serem reconhecidas pelo autoload PSR-4.

JSON_THROW_ON_ERROR

Flag para tratamento de erros de json_decode() no PHP 7.3+; ao ativar, falha na análise JSON lança exceção JsonException. O exemplo Laravel desta ferramenta usa análise rigorosa.

Hash (PHP)

Função de hash integrada do PHP, comumente usada para verificação de assinatura WebHook. As classes de callback WebHook geradas por esta ferramenta funcionam com hash_hmac() para verificação de assinatura.

Tabela de referência mapeamento tipo JSON para tipo PHP

Tipos de dados JSON detectados automaticamente pela ferramenta e referência do tipo PHP correspondente:

Tabela de comparação 4 estilos de código PHP

4 estilos de código de classe PHP suportados pela ferramenta; escolha conforme necessidades do projeto:

Privacy & Security

Todas as operações de análise JSON, geração de classes PHP, empacotamento ZIP desta ferramenta JSON para PHP ocorrem completamente localmente no seu navegador via JavaScript (quicktype-core + JSZip); os dados JSON de entrada e o código PHP gerado não são enviados para nenhum servidor, nem salvos, colocados em cache ou armazenados na nuvem. JSON sensível contendo campos de interface interna, estruturas de negócio não lançadas, respostas de API não públicas pode ser usado com segurança; todos os dados são apagados ao fechar a página. Esta ferramenta não usa nenhum Cookie para rastreamento de usuários, não coleta informações de e-mail ou conta, não integra scripts de estatísticas de terceiros; todos os cálculos ocorrem no processo do navegador do dispositivo atual. Mesmo em ambiente offline (ex. desconectado ou intranet isolada) funciona normalmente, desde que os recursos da página tenham sido carregados uma vez.

Authoritative References

• PHP.netDocumentação oficial PHP - Classes e objetos
• PHP.netDocumentação oficial PHP - Interface JsonSerializable
• PHP.netDocumentação oficial PHP - Modificador Readonly (PHP 8.1+)
• PHP.netDocumentação oficial PHP - Propriedades tipadas (PHP 7.4+)
• PHP-FIGPadrão Autoload PSR-4
• LaravelDocumentação oficial Laravel - Eloquent: API Resources
• SymfonyDocumentação do componente Symfony Serializer
• ComposerDocumentação oficial Composer - Autoload PSR-4