Indentar código PHP

Como a indentação é calculada

A ferramenta mantém um contador de profundidade. Cada chave de abertura soma um nível e cada chave de fechamento subtrai um. Cada linha recebe o número de espaços escolhido multiplicado pela profundidade atual. A indentação usa sempre espaços, nunca tabulações.

Esta é a mesma função com cada configuração. A entrada era function total($items){$sum=0;foreach($items as $item){$sum+=$item["price"];}return $sum;}.

Com 4 espaços:

function total($items)
{
    $sum=0;
    foreach($items as $item)
    {
        $sum+=$item["price"];
    }
    return $sum;
}

Com 2 espaços:

function total($items)
{
  $sum=0;
  foreach($items as $item)
  {
    $sum+=$item["price"];
  }
  return $sum;
}

2 espaços ou 4 espaços

Quatro espaços é a convenção mais usada em projetos PHP e a que a maioria dos guias de estilo pede. Dois espaços mantém o código muito aninhado mais estreito, o que ajuda ao colar em um campo pequeno de chamado ou em uma mensagem de chat. Use o que a sua equipe usa.

Coisas que você deve saber

• Tabulações da entrada não são preservadas, pois o espaçamento ao redor de chaves e ponto e vírgulas é refeito.
• A indentação depende apenas das chaves. Código que continua por várias linhas dentro de parênteses, como um array longo, não recebe indentação extra.
• Uma chave dentro de um comentário ou de um heredoc ainda é contada, o que pode deslocar a profundidade de tudo o que vem depois.
• Chaves desbalanceadas não são sinalizadas. Se as chaves de fechamento acabarem, a profundidade fica em zero e as linhas seguintes não são indentadas.

Como corrigir código que perdeu a indentação

A indentação costuma desaparecer quando o código passa por um campo de formulário, um e-mail, uma ferramenta de chat ou um arquivo de log. Colá-lo aqui reconstrói a estrutura a partir das chaves, então você não precisa realinhar cada linha à mão. Isso ajuda mais em classes, em que métodos e corpos ficam em profundidades diferentes, e em funções longas com vários laços e condições aninhados.

Confira o resultado

Depois de formatar, observe a borda esquerda. Cada chave de fechamento deve ficar alinhada com a linha que abriu o bloco. Se a última chave estiver indentada, ou se o código depois de um bloco estiver deslocado demais, falta ou sobra uma chave na sua entrada. Corrija isso primeiro e rode a ferramenta de novo.