JSON Swiss

JSON Swiss

Gerador de Classe PHP para JSON Schema

Entrada Código PHP

Carregando editor…

Saída JSON Schema

Configurações

Selecione qual classe PHP deve ser tratada como raiz ao gerar o schema.

A análise ocorre inteiramente no seu navegador. Seu código não sai da página.

Cole suas classes PHP para produzir JSON Schema instantaneamente.

Suporta propriedades tipadas, anotações DocBlock, tipos nullable/union, arrays e mapas associativos.

Como converter classes em PHP para JSON Schema – guia passo a passo

Este conversor online de classe PHP para JSON Schema ajuda você a gerar JSON Schema a partir de modelos reais (DTOs, structs e classes) para validar payloads, compartilhar contratos e gerar JSON mock.

  1. Etapa 1 – Cole sua fonte em PHP

    • Cole os modelos que você quer documentar no editor à esquerda.
    • Inclua tipos referenciados no mesmo trecho para que o schema possa gerar definitions.
    • Use o botão Exemplo para carregar um exemplo e ver o formato de entrada esperado.

  2. Etapa 2 – Selecione o Classe raiz (se necessário)

    • Se múltiplas definições forem detectadas, escolha a raiz que corresponde ao payload da sua API.
    • O schema de saída é construído em torno da raiz selecionada e pode incluir definições adicionais para tipos referenciados.

  3. Etapa 3 – Revise a saída do JSON Schema

    • Verifique tipos, campos obrigatórios vs opcionais e estruturas aninhadas de objeto/array.
    • Procure por definitions e $ref quando seus modelos referenciam outros modelos.
    • Copie ou baixe o schema para validação, documentação ou desenvolvimento schema-first.

  4. Etapa 4 – Valide ou gere JSON mock

    • Clique em Gerar dados mock para abrir o gerador de mock com seu schema pré-carregado.
    • Valide payloads reais contra o schema para detectar breaking changes cedo.
    • Se você depender de composição avançada de schema (por exemplo anyOf/oneOf/allOf), verifique o resultado com um validador completo como o Ajv.

Observação sobre suporte a keywords de schema

Schemas gerados podem incluir $ref e podem ser editados para incluir anyOf, oneOf, ou allOf. Para schemas complexos, use um validador completo de JSON Schema e faça dereference antes de gerar mock data, se necessário.

Ferramentas relacionadas de JSON Schema e geração de código

Use estas ferramentas para validar schemas, gerar payloads mock, formatar exemplos JSON e manter código e contratos alinhados.

Gerador de dados mock de JSON Schema

Gere JSON de exemplo a partir do seu schema para testes, fixtures e documentação.

Validador de JSON Schema

Valide JSON contra keywords comuns de schema e encontre inconsistências rapidamente.

JSON para Classes em PHP

Gere tipos e modelos em PHP a partir de exemplos JSON.

Gerador de JSON para JSON Schema

Crie schema a partir de exemplos JSON representativos para complementar schemas model-first.

Schema Library

Explore exemplos e padrões de schema para objetos, arrays, enums e constraints.

JSON Formatter

Limpe exemplos JSON antes de validar contra schema ou compartilhar documentação.

Perguntas Frequentes

Qual sintaxe PHP é suportada?

O conversor lê definições de classe com propriedades tipadas ou anotações DocBlock @var, reconhecendo visibilidade, tipos nullable, arrays e hints de DateTime/UUID. Propriedades marcadas como json-ignore ou JsonIgnore são ignoradas automaticamente.

Como tipos PHP são mapeados para JSON Schema?

string, int, float, bool, array e classes custom são mapeados para equivalentes no JSON Schema. Tipos nullable e union marcam campos como opcionais, arrays viram arrays no schema e padrões array<string, T> são tratados como mapas. Classes desconhecidas viram string a menos que outra classe PHP com o mesmo nome esteja definida.

Funciona com frameworks como Laravel ou Symfony?

Sim. Você pode colar DTOs, form requests ou entities com propriedades tipadas ou hints em DocBlock. A ferramenta roda inteiramente no navegador, então seu código não sai da sua máquina.

Como gerar dados JSON mock?

Depois de gerar o schema, clique em "Gerar dados mock" para abrir o Mock Generator com o schema pré-carregado. Configure locale e opções para criar payloads para docs ou testes.

Gerador de Classe PHP para JSON Schema | JSONSwiss