Llaves de PHP en una línea nueva

Colocación de las llaves en esta herramienta

La herramienta tiene un único diseño y no ofrece ninguna opción para cambiarlo: cada { empieza en su propia línea, cada } ocupa una línea propia y lo que hay dentro se sangra un nivel. Por eso else y catch empiezan en una línea nueva después de la llave de cierre.

Entrada con las llaves al final de la línea:

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

Resultado:

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

¿Qué estilo debes usar?

Las guías de estilo de PHP más comunes colocan la llave de apertura de una clase o un método en su propia línea, mientras que las estructuras de control como if y foreach mantienen la llave en la misma línea que la instrucción. Esta herramienta aplica el diseño de línea nueva en todos los casos. Eso es correcto para clases y métodos, y una elección deliberada para el resto. Si tu proyecto sigue la convención mixta, tendrás que volver a unir a mano las llaves de las estructuras de control.

Notas prácticas

• Los bloques anidados siguen avanzando, así que un bucle dentro de un método dentro de una clase acaba a tres niveles de profundidad.
• Las llaves de cierre van seguidas de un salto de línea, de modo que una } y el código que sigue nunca comparten línea.
• Las llaves dentro de comentarios y de texto parecido a una cadena, como los heredocs, se cuentan como llaves reales y pueden desplazar el diseño.
• No hay ninguna opción para mantener la llave de apertura en la línea de la instrucción. Esta página no puede producir ese estilo.

Ejemplo con una clase

Entrada:

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

Resultado con 4 espacios:

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

La llave de la clase y la del método ocupan cada una su línea, y el cuerpo del método está sangrado un nivel más que la propiedad de arriba. Las llaves de cierre se alinean con la línea que las abrió, así que puedes emparejar los bloques a simple vista.

Combinarlo con tu propio estilo

Si solo algunos bloques necesitan cambiar, pega solo esos bloques. El resultado se vuelve a integrar fácilmente en un archivo con copiar y pegar, porque cada bloque termina en su propia llave de cierre. No pegues un fragmento que empiece o termine a mitad de un bloque, porque la profundidad de sangría parte de cero y no coincidirá con el archivo que lo rodea.