Laravel Code Formatter

Esta ferramenta formata o código Laravel PHP aplicando um conjunto padronizado de regras de formatação que mantêm o comportamento e melhoram a legibilidade. Aponta para desenvolvedores que mantêm aplicativos Laravel, revisores de código e pipelines CI que impõem estilo. Ao alinhar indentação, espaçamento e instruções use a uma norma comum, reduz-se o desvio entre arquivos e equipes. Não altera a lógica de negócio nem o comportamento em tempo de execução.

O processo central começa com a tokenização PHP, seguido de transformações baseadas em regras. Ele aplica os fundamentos PSR-12 e convenções Laravel específicas, como agrupar instruções use, formatação de arrays consistente e visibilidade explícita quando aplicável. Perfis opcionais oferecem controle mais profundo: indentação de 2 ou 4 espaços, comprimento máximo de linha, preferências por vírgulas finais e formatação sensível à versão PHP. A saída é um novo bloco de código semanticamente idêntico, porém com apresentação uniforme.

Entradas incluem a string de código, um perfil de formatação selecionado e preferências opcionais. Saídas fornecem formatted_code e diff/patch opcional. Validação detecta entradas vazias e problemas básicos de sintaxe; erros de sintaxe retornam diagnósticos sem aplicar alterações. Valores padrão asseguram comportamento previsível quando opções são omitidas, facilitando adoção rápida em repositórios diversos.

Público-alvo: equipes Laravel, freelancers e pipelines de ferramentas. O valor reside em reduzir o esforço manual de formatação, acelerar revisões de código e melhorar a manutenibilidade, mantendo as convenções Laravel. Refatoração semântica, templates Blade ou transformações de código em tempo de execução ficam fora do escopo.