Formatador de PHP

O que esta ferramenta faz

O formatador de PHP transforma código PHP bagunçado, minificado ou com indentação inconsistente em código limpo que segue o padrão de código da comunidade. Ele lida com sintaxe moderna, incluindo propriedades tipadas e readonly, promoção de construtor, arrow functions, enums, expressões match e atributos.

Ele roda o Prettier com o plugin oficial de PHP, a mesma combinação que muitas equipes de Laravel e Symfony usam nos editores e em hooks de pre-commit, então o resultado bate com o que as suas ferramentas produziriam.

Como usar

1. Cole código PHP ou abra um arquivo .php. A tag de abertura <?php é opcional para trechos curtos.
2. O código formatado aparece à direita enquanto você digita.
3. Ajuste as opções:
   • Indentação: 4 espaços é o padrão PSR; 2 espaços e tabs também estão disponíveis.
   • Largura da linha: linhas mais longas que isso são quebradas onde a sintaxe permite.
   • Chaves: coloque as chaves de classes e funções na linha seguinte (PER / PSR-12) ou na mesma linha.
   • Versão do PHP: a versão mais antiga em que o código precisa rodar.
   • Aspas simples e Vírgulas finais para listas em várias linhas.
4. Copie ou baixe o resultado.

Se o código tiver um erro de sintaxe, a mensagem diz o que o parser esperava e a linha e a coluna onde ele parou.

Exemplo

O exemplo é um controller no estilo Laravel com tudo amontoado: uma instrução use agrupada, um array de propriedades, promoção de construtor, uma chamada de validação, um if escrito em uma linha e um array_map com arrow function. Depois da formatação, a chave de cada método vai para uma linha própria, operadores e => ganham espaços, o corpo do if é expandido e as chamadas longas de response()->json() são quebradas com um item do array por linha e vírgulas finais.

O que ele não muda

O formatador só muda o layout. Ele não renomeia variáveis, não reordena instruções use, não converte array() para a sintaxe curta nem corrige lógica. Comentários, incluindo blocos PHPDoc, são preservados e reindentados junto com o código ao redor.

Dicas

• Use a mesma largura de linha e versão do PHP da configuração do Prettier ou do PHP-CS-Fixer do seu projeto para evitar ruído nos diffs.
• Formatar um trecho copiado de um log ou stack trace o deixa muito mais fácil de ler.
• Se for compartilhar código em uma issue, formate-o antes para que os revisores possam se concentrar no que ele faz.