Loading…

Sobre este Formatador PHP Embelezador PHP Online

Tem código PHP confuso de projetos legados, hacks rápidos ou trechos copiados? Este formatador PHP online executa seu código através do Prettier com o plugin oficial PHP, fornecendo saída no estilo PSR-12 com indentação, espaçamento e arrays consistentes em segundos. Perfeito para Laravel, Symfony, WordPress, APIs e CLIs.

Por Que Usar Este Formatador PHP?

  • Formatação alinhada ao PSR-12 para bases de código PHP modernas
  • Alimentado por Prettier + @prettier/plugin-php para saída estável e opinativa
  • Opções para tamanho de indentação, espaços vs tabs e quebra / comprimento de linha
  • Normaliza espaçamento, indentação, arrays, estruturas de controle e chaves
  • Funciona com arquivos .php, .phtml, .php5, .php4 e .inc
  • Formatação rápida no navegador com fallback automático para um backend seguro quando necessário
  • Ótimo para Laravel, Symfony, WordPress, frameworks personalizados e aplicações legadas

🔧 Como Embelezar Código PHP em 4 Passos for php-formatter

1

1. Cole ou arraste seu código

Cole seu código PHP no editor, ou arraste e solte um arquivo `.php` / `.phtml` / `.inc`. A ferramenta detecta automaticamente a sintaxe PHP e a prepara para formatação.

2

2. Configure as opções de formatação

Escolha o tamanho da indentação, se usa espaços ou tabs e o comprimento de linha / quebra preferido. Os padrões são sensatos para a maioria dos projetos de estilo PSR-12.

3

3. Clique em “Formatar”

Pressione **Formatar** para executar seu código através do mecanismo PHP do Prettier. Em casos típicos, o resultado aparece quase instantaneamente.

4

4. Revise, copie e faça commit

Revise a saída formatada, depois copie de volta para seu editor ou baixe como um arquivo `.php`. Faça commit da versão limpa para manter futuras diferenças organizadas.

Especificações Técnicas

Padrões e Suporte de Sintaxe

O formatador PHP é ajustado para frameworks e bibliotecas modernas, mantendo a sintaxe clássica funcionando suavemente.

FuncionalidadeSuportadoNotas
Alinhamento PSR-12✅ SimEstilo opinativo amplamente alinhado com PSR-12 e práticas comuns da comunidade.
Sintaxe PHP 7+✅ SimNamespaces, dicas de tipo escalar, tipos de retorno, tipos anuláveis, etc.
Funcionalidades PHP 8+✅ SimAtributos, tipos de união, promoção de construtor, expressões match, funções arrow.
Sintaxe curta de array✅ SimNormaliza arrays para o estilo moderno `[ ... ]` quando apropriado.
Heredoc / Nowdoc✅ SimPreserva o conteúdo enquanto limpa a indentação circundante.
PHP misto + HTML✅ SimPode formatar templates `.php` típicos contendo HTML incorporado.

Regras de Limpeza e Layout

O motor PHP do Prettier foca apenas no layout—o comportamento do seu código permanece o mesmo.

ÁreaO que é normalizado?Por que ajuda
IndentaçãoTamanho de indentação consistente usando espaços ou tabs conforme suas configuraçõesRemove o desvio de indentação manual ao longo do tempo.
EspaçamentoEspaços ao redor de operadores, vírgulas, estruturas de controle e palavras-chaveTorna expressões e condições mais fáceis de ler.
Chaves e blocosPosicionamento estável de chaves para classes, funções e fluxo de controlePreveni guerras de estilo e mantém os diffs previsíveis.
ArraysElementos em múltiplas linhas quando necessário, regras consistentes de vírgulas finaisMelhora arrays de configuração grandes e cargas úteis.
Linhas em brancoAgrupamento razoável entre funções, métodos e classesDá aos arquivos uma estrutura clara e legível.

Modelo de Execução e Limites

Projetado para ser rápido e seguro em um ambiente de navegador.

AspectoValor / ComportamentoNotas
Motor de execuçãoPrettier + @prettier/plugin-phpExecuta no navegador sempre que o plugin estiver disponível.
FallbackBackend seguro `/api/php-formatter`Usado apenas se o plugin PHP não puder ser carregado no lado do cliente.
Tempo limite~25 segundosAs solicitações são abortadas se a formatação demorar muito.
Tamanho máximo de entrada (texto)~2 MBBarreira rígida na lógica do formatador.
Tamanho máximo de arquivo (upload)~5 MBDefinido pela configuração `maxFileSizeBytes` da ferramenta.
Para grandes monorepos ou refatorações em massa, execute Prettier ou PHP-CS-Fixer localmente em sua base de código em vez de depender de qualquer ferramenta online.

Privacidade e Segurança

Esta ferramenta é destinada a trechos de desenvolvimento do dia a dia, em vez de código de produção altamente sensível.

AspectoComportamento
Formatação no lado do clienteCaminho preferido usando o runtime Prettier do navegador.Evita o envio de código pela rede em condições normais.
Fallback do backendSe o plugin PHP não puder ser carregado, o código é enviado via HTTPS para um endpoint de formatação seguro.Processado como entrada transitória apenas para formatação.
ArmazenamentoNão há intenção de armazenamento de longo prazo da entrada bruta.Apenas métricas agregadas de erro/desempenho podem ser coletadas.
Melhor práticaNão cole segredos, tokens de acesso ou senhas em qualquer formatador online.Mantenha o código sensível à segurança em ferramentas locais e CI.

Formatação PHP via Linha de Comando (Prettier & PHP-CS-Fixer)

Quando você está trabalhando dentro de um projeto, as ferramentas locais são a melhor maneira de impor um estilo consistente em todo o repositório.

Node / npm

Instalar Prettier com plugin PHP

npm install --save-dev prettier @prettier/plugin-php

Adiciona Prettier e seu plugin PHP ao seu projeto.

Formatar um único arquivo PHP

npx prettier --write src/Example.php --parser php

Aplica o mesmo estilo usado por esta ferramenta online.

Formatar todos os arquivos PHP em um projeto

npx prettier "src/**/*.php" --parser php --write

Mantém toda a base de código consistentemente formatada.

PHP-CS-Fixer

Instalar PHP-CS-Fixer globalmente com Composer

composer global require friendsofphp/php-cs-fixer

Adiciona um poderoso fixador de estilo específico para PHP ao seu kit de ferramentas de CLI.

Executar com regras PSR-12

php-cs-fixer fix src --rules=@PSR12

Aplica PSR-12 a todos os arquivos PHP em `src`.

Use esta página para limpezas rápidas e pontuais, depois confie no Prettier ou PHP-CS-Fixer em CI e ganchos de pré-commit para manter toda a sua equipe no mesmo estilo.

Casos de Uso Comuns para o Embelezador PHP

Laravel / Symfony / Backends de API

Organize controladores, serviços e DTOs antes da refatoração ou revisão de código.

  • Normalizar a formatação de controladores HTTP e manipuladores de formulários.
  • Limpar classes de serviço e repositórios compartilhados entre equipes.
  • Garantir estilo consistente em microsserviços e APIs.
// Antes
class OrderController extends Controller{public function store(Request $request){$order=$this->service->create($request->all());return response()->json($order,201);}}

// Depois
class OrderController extends Controller
{
  public function store(Request $request)
  {
    $order = $this->service->create($request->all());

    return response()->json($order, 201);
  }
}

WordPress e Bases de Código Legadas

Aproxime projetos antigos de PHP 5 / 7 dos padrões modernos sem reescrever tudo.

  • Embelezar código de temas e plugins antes da depuração.
  • Limpar trechos de código bagunçados e copiados de tutoriais.
  • Mover gradualmente arquivos legados para as convenções PSR-12.

Ensino e Revisões de Código

Use a formatação para focar na lógica e arquitetura em vez da colocação de chaves.

  • Mostrar aos alunos como um estilo consistente melhora a legibilidade.
  • Anexar exemplos antes/depois em pull requests para destacar melhorias.
  • Usar como uma verificação rápida de sanidade para amostras de código em posts de blog e documentação.
// Exemplo de exercício: peça aos alunos que prevejam o resultado formatado
if($user&&$user->isAdmin()){logAction($user,"login");}

❓ Frequently Asked Questions

❓Esta ferramenta suporta recursos modernos do PHP 8?

Sim. O formatador suporta a sintaxe típica do PHP moderno, incluindo dicas de tipo, tipos de união, promoção de construtores, atributos, expressões match e funções arrow.

🔧Posso alterar a largura da tabulação ou usar tabs em vez de espaços?

Absolutamente. Você pode escolher o tamanho do recuo (1–8) e se a indentação usa espaços ou tabs. O formatador aplica essas configurações consistentemente em todo o seu arquivo.

📏Como é tratada a quebra de linha?

Use a opção de quebra / comprimento de linha para indicar quão largas as linhas devem ser. Definir 0 efetivamente desativa a quebra usando um limite interno muito grande.

🔐Meu código é enviado para seus servidores?

A ferramenta prefere a formatação no navegador via Prettier. Se o motor PHP não puder ser carregado em seu ambiente, ele recorre a uma API segura para formatação. Em ambos os casos, a entrada é destinada a ser transitória e não armazenada a longo prazo, mas você ainda deve evitar colar segredos ou dados altamente sensíveis.

🧮A formatação alterará a execução do meu código PHP?

O formatador apenas altera o layout—espaços em branco, indentação, quebras de linha e similares. Ele não altera intencionalmente a semântica. Dito isso, sempre execute sua suíte de testes após grandes refatorações automatizadas.

⚙️Como imponho o mesmo estilo no meu projeto?

Use o Prettier com o plugin PHP ou o PHP-CS-Fixer em seu projeto e pipeline de CI. Esta ferramenta online é uma interface conveniente para correções rápidas; ferramentas locais são melhores para impor estilo em escala.

Pro Tips

Best Practice

Adicione uma etapa de formatação (Prettier ou PHP-CS-Fixer) ao seu pipeline de CI para que nenhum PHP não formatado chegue ao `main`.

Best Practice

Execute o formatador antes de abrir um pull request para manter os diffs focados em mudanças de comportamento, não em espaços em branco.

Best Practice

Para grandes refatorações, formate todo o projeto uma vez em um branch dedicado, mescle-o e, em seguida, faça alterações lógicas em PRs separados.

Best Practice

Trate ferramentas online como terminais compartilhados: evite colar segredos de produção e chaves internas em qualquer formulário web.

Additional Resources

Guia de Estilo de Codificação PSR-12
Documentation
Plugin PHP do Prettier
Documentation
Manual do PHP
Documentation
PHP-CS-Fixer
Documentation

Other Tools