1. JSON e PHP: Conversao Nativa

PHP possui suporte nativo para JSON desde a versao 5.2 com as funcoes json_encode() e json_decode(). A funcao json_decode($json, true) converte uma string JSON diretamente para um array associativo PHP — o equivalente a este conversor, mas em runtime.

Este conversor e util quando voce precisa do codigo PHP estatico (para configuracoes, seeds de banco de dados, mocks de testes) em vez de decodificar JSON dinamicamente.

2. Arrays Associativos PHP

Arrays PHP sao estruturas flexiveis que funcionam como arrays indexados e como mapas chave-valor simultaneamente. A sintaxe [] (PHP 5.4+) e equivalente a array() mas mais moderna e amplamente preferida.

• Chaves podem ser strings ou inteiros
• Arrays podem ser aninhados sem limite de profundidade
• Valores null JSON viram null PHP
• Booleanos JSON (true/false) viram true/false PHP (minusculos)

"A sintaxe curta [] foi introduzida no PHP 5.4 e hoje e o padrao recomendado pelo PSR e pelas principais style guides da comunidade PHP."

3. Gerando Classes PHP

O modo de classe gera uma classe PHP com propriedades publicas tipadas (usando tipos escalares do PHP 7+) e um construtor que aceita um array $data. Esse padrao e util para criar Value Objects ou DTOs (Data Transfer Objects) a partir de respostas de API.

4. Mapeamento de Tipos

Mapeamento JSON → PHP usado neste conversor:

• string → string (entre aspas simples)
• number inteiro → int
• number decimal → float
• boolean → bool (true/false minusculos)
• null → null
• array → array indexado PHP
• object → array associativo PHP

5. Boas Praticas

• Prefira a sintaxe [] para novos projetos (PHP 5.4+).
• Use json_decode($json, true) em producao para decodificacao dinamica.
• Para APIs, considere usar bibliotecas como Spatie Laravel Data ou Fractal para transformacao de dados.
• Sempre valide o JSON antes de processar: use json_last_error() ou json_validate() (PHP 8.3+).

6. Perguntas Frequentes

Qual a diferenca entre [] e array()?

Sao funcionalmente identicos. A sintaxe [] e mais curta e moderna (PHP 5.4+). A sintaxe array() e necessaria apenas se voce precisar de compatibilidade com PHP anterior a 5.4, o que e raro hoje em dia.

Como converter o array PHP de volta para JSON?

Use json_encode($data, JSON_PRETTY_PRINT) para converter um array PHP para uma string JSON formatada. Adicione JSON_UNESCAPED_UNICODE para preservar caracteres acentuados sem escape.

O conversor suporta JSON com arrays na raiz?

Sim. Se o JSON raiz for um array (em vez de um objeto), o conversor gera um array PHP indexado. Para o modo de classe, o primeiro elemento do array e usado como referencia para as propriedades.