Formatador de PHP
Formate código PHP com um estilo consistente e legível usando o plugin Prettier PHP, próximo das convenções PSR-12. Cole um arquivo que comece com <?php para obter espaçamento e chaves normalizados, arrays e encadeamentos de métodos organizados, além de listas longas de argumentos distribuídas conforme a largura de impressão. Erros de sintaxe são informados com a mensagem do analisador, a linha e a coluna, ajudando desenvolvedores PHP a organizar código legado antes da revisão.
Perguntas frequentes
Qual formatador é usado?
A ferramenta executa Prettier 3 com @prettier/plugin-php 0.26 no servidor. A saída segue um estilo próximo do PSR-12: quatro espaços por nível por padrão, chaves de abertura de classes e funções em linhas próprias e uma instrução por linha.
Meu código precisa de uma tag de abertura <?php?
Sim. O plugin formata o código dentro das tags PHP. Tudo que estiver fora delas é tratado como HTML em linha e mantido como está; assim, um trecho sem <?php retorna sem alterações.
Quais versões de PHP são compatíveis?
A sintaxe moderna do PHP 8 é compreendida, incluindo atributos, enums, expressões match, funções de seta, argumentos nomeados, promoção de propriedades do construtor e classes readonly. Código mais antigo de PHP 5 e 7 também é formatado.
O formatador vai alterar o que meu código faz?
Não. Ele altera apenas a apresentação. Algumas reescritas puramente cosméticas podem ocorrer; por exemplo, a sintaxe array() longa pode virar a sintaxe curta equivalente [], mas o comportamento do código permanece igual.
O que acontece quando há um erro de sintaxe?
A formatação é interrompida, e a ferramenta exibe a mensagem do analisador com a linha e a coluna, por exemplo, se faltar um parêntese de fechamento. Corrija esse ponto e formate novamente.
Posso usar tabulações ou dois espaços?
Sim. Escolha 2 ou 4 espaços, ou ative as tabulações. A largura de impressão, de 40 a 200 caracteres, 80 por padrão, determina quando chamadas, arrays e condições são distribuídos em linhas separadas.
Os comentários e blocos docblock são mantidos?
Sim. Comentários de linha, comentários de bloco e blocos PHPDoc permanecem junto ao código que descrevem. O texto deles não é reorganizado.
Ele pode formatar modelos que misturam HTML e PHP?
Ele formata os blocos PHP nesses modelos e mantém intacto o HTML entre eles. Arquivos de modelo complexos ainda podem precisar de ajustes manuais.
Quanto código posso formatar de uma vez?
Até 1 MB de código por solicitação, e a formatação é interrompida após 10 segundos. Isso inclui até arquivos únicos muito grandes.
Meu código fica armazenado no servidor?
Não. O código é formatado na memória e devolvido imediatamente. Ele não é salvo; apenas os tamanhos das solicitações são registrados.