Chaves do PHP em nova linha

Posicionamento das chaves nesta ferramenta

A ferramenta tem um único layout e não oferece opção para mudá-lo: cada { começa na sua própria linha, cada } fica em uma linha própria e o conteúdo interno é indentado um nível. Por isso, else e catch começam em uma nova linha depois da chave de fechamento.

Entrada com as chaves no fim da linha:

<?php if ($age >= 18) { echo "adult"; } else { echo "minor"; }

Resultado:

<?php if ($age >= 18)
{
    echo "adult";
}
else
{
    echo "minor";
}

Qual estilo você deve usar?

Guias de estilo comuns em PHP colocam a chave de abertura de uma classe ou de um método em uma linha própria, enquanto estruturas de controle como if e foreach mantêm a chave na mesma linha da instrução. Esta ferramenta aplica o layout de nova linha em todos os casos. Isso é correto para classes e métodos, e uma escolha deliberada para o restante. Se o seu projeto segue a convenção mista, você precisará juntar de volta, à mão, as chaves das estruturas de controle.

Observações práticas

• Blocos aninhados continuam avançando, então um laço dentro de um método dentro de uma classe fica com três níveis de profundidade.
• Chaves de fechamento são seguidas de uma quebra de linha, então um } e o código depois dele nunca compartilham a mesma linha.
• Chaves dentro de comentários e de textos semelhantes a strings, como heredocs, são contadas como chaves reais e podem alterar o layout.
• Não existe opção para manter a chave de abertura na mesma linha da instrução. Esta página não consegue produzir esse estilo.

Exemplo com uma classe

Entrada:

<?php class User{private $name;public function getName(){return $this->name;}}

Resultado com 4 espaços:

<?php class User
{
    private $name;
    public function getName()
    {
        return $this->name;
    }
}

A chave da classe e a do método ficam cada uma em sua linha, e o corpo do método é indentado um nível a mais do que a propriedade acima dele. As chaves de fechamento alinham-se com a linha que as abriu, então você pode relacionar os blocos a olho.

Como misturar com o seu próprio estilo

Se apenas alguns blocos precisam mudar, cole somente esses blocos. O resultado é fácil de mesclar de volta em um arquivo por copiar e colar, porque cada bloco termina na sua chave de fechamento. Não cole um fragmento que comece ou termine no meio de um bloco, porque a profundidade de indentação começa em zero e não vai combinar com o arquivo ao redor.