Фигурные скобки PHP на новой строке

Расположение скобок в этом инструменте

У инструмента есть только одна раскладка, и выбрать другую нельзя: каждый { начинает собственную строку, каждый } стоит на своей строке, а содержимое внутри сдвигается на один уровень. Поэтому else и catch начинаются с новой строки после закрывающей скобки.

Исходные данные с фигурными скобками в конце строки:

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

Результат:

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

Какой стиль выбрать?

Распространенные руководства по стилю PHP ставят открывающую скобку класса или метода на отдельную строку, а управляющие конструкции, такие как if и foreach, обычно оставляют скобку на той же строке, что и оператор. Инструмент применяет раскладку с новой строкой везде. Это правильно для классов и методов, а для остального является осознанным выбором. Если в вашем проекте принята смешанная конвенция, скобки управляющих конструкций придется вернуть на место вручную.

Практические замечания

• Вложенные блоки по-прежнему смещаются, поэтому цикл внутри метода внутри класса окажется на третьем уровне глубины.
• После закрывающей скобки всегда идет перенос строки, поэтому } и код после нее никогда не стоят на одной строке.
• Фигурные скобки в комментариях и в текстах, похожих на строки, например в heredoc, считаются настоящими скобками и могут сдвинуть разметку.
• Настройки, которая оставила бы открывающую скобку на строке оператора, нет. Эта страница не может создать такой стиль.

Пример с классом

Исходные данные:

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

Результат с 4 пробелами:

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

Скобка класса и скобка метода стоят отдельно, а тело метода сдвинуто на уровень глубже, чем свойство выше. Закрывающие скобки выровнены по строке, которая их открыла, поэтому блоки легко сопоставить глазами.

Совмещение с собственным стилем

Если нужно изменить только некоторые блоки, вставьте только их. Результат легко вернуть в файл копированием и вставкой, потому что каждый блок заканчивается на своей закрывающей скобке. Не вставляйте фрагмент, который начинается или заканчивается посреди блока, так как глубина отсчитывается от нуля и не совпадет с окружающим файлом.