JSON Swiss

JSON Swiss

Gerador de JSON para PHP

Entrada JSON

Carregando editor…

PHP Gerado

Configuration

Opções de geração PHP

Insira dados JSON para gerar classes PHP

Classes PHP com propriedades tipadas e suporte à serialização JSON

Como converter JSON para PHP – guia passo a passo

Use este gerador JSON para PHP para criar classes PHP a partir de amostras JSON para Laravel, Symfony e integrações de back-end.

  1. Passo 1 – Cole uma amostra JSON

    • Cole um objeto ou matriz JSON representativo no editor esquerdo.
    • Inclua objetos aninhados, matrizes e campos anuláveis para que os tipos sejam inferidos corretamente.
    • Use Import para carregar JSON de um arquivo, URL ou dados de amostra.

  2. Passo 2 – Escolha as opções de classe PHP

    • Defina um Class Name raiz e um namespace se você usar o carregamento automático PSR-4.
    • Decida como representar campos opcionais (tipos anuláveis como ?string).
    • Revise objetos e matrizes aninhados para que sejam mapeados para classes dedicadas e matrizes digitadas sempre que possível.

  3. Passo 3 – Revise o código gerado

    • Verifique nomes de campos, tipos e como matrizes/objetos são modelados.
    • Ajuste opções como Root Type Name, tratamento nulo e estruturas, se disponíveis.
    • Se um campo for inferido incorretamente, ajuste seu JSON de amostra e gere-o novamente.

  4. Passo 4 – Use as classes em PHP

    • Copie as classes em seu projeto e certifique-se de que o carregamento automático esteja configurado.
    • Mapeie matrizes JSON decodificadas em seus DTOs (ou use um hidrator).
    • Valide os campos obrigatórios antes de usar os dados na lógica de negócios.

  5. Passo 5 – Copiar ou baixar

    • Copie a saída em seu projeto ou baixe-a como um arquivo.
    • Execute seu formatador/linter para corresponder ao seu estilo de código.
    • Adicione bibliotecas de análise/serialização JSON se sua linguagem exigir.

Dicas rápidas

  • Prefira propriedades digitadas (PHP 7.4+) para contratos mais claros.
  • Mantenha os DTOs separados dos modelos ORM para evitar acoplamento.
  • Se você aceitar JSON externo, valide primeiro com um esquema JSON.
Saída de exemplo (simplificada)
// Entrada JSON
{
  "id": 123,
  "name": "Maeve Winters",
  "email": "[email protected]",
  "active": true,
  "roles": ["admin", "editor"],
  "metadata": { "plan": "pro" },
  "createdAt": "2024-03-01T10:15:00Z",
  "score": 99.5,
  "notes": null
}

// Generated PHP DTOs (simplified)
final class Metadata {
  public string $plan;
}

final class Root {
  public int $id;
  public string $name;
  public ?string $email;
  public bool $active;
  /** @var string[] */
  public array $roles;
  public Metadata $metadata;
  public string $createdAt;
  public float $score;
  public mixed $notes;
}

Ferramentas JSON e PHP relacionadas

Explore mais ferramentas JSON e de esquema que funcionam muito bem junto com este gerador JSON para PHP.

Classe PHP para JSON e esquema JSON

Converta classes PHP existentes em exemplos JSON e esquema JSON para documentos e validação.

Gerador de esquema JSON

Gere um esquema JSON a partir de amostras JSON para validar cargas e contratos.

Formatador e validador JSON

Formate e valide o JSON antes de gerar classes PHP para evitar problemas de tempo de execução.

Gerador JSON para TypeScript

Gere tipos de front-end que correspondam às mesmas cargas úteis da API PHP.

Perguntas Frequentes

Quais recursos de PHP são suportados?

O gerador cria classes PHP com propriedades tipadas (PHP 7.4+), suporta serialização JSON e segue convenções de nomenclatura com namespaces apropriados.

Como a serialização JSON é tratada?

As classes geradas incluem métodos para converter de/para array e JSON, compatíveis com json_encode e json_decode.

Suporta PHPDoc?

Sim. O gerador pode adicionar anotações PHPDoc para ajudar a IDE a inferir tipos e melhorar a experiência de desenvolvimento.

Como arrays e objetos aninhados são tratados?

Arrays são mapeados para arrays PHP com documentação de tipo, e objetos aninhados geram classes separadas para lidar com estruturas complexas.

Gerador de JSON para PHP | JSONSwiss