Отступы в коде PHP

Как вычисляются отступы

Инструмент ведет счетчик глубины. Каждая открывающая фигурная скобка добавляет уровень, а каждая закрывающая его убирает. Каждая строка дополняется выбранным количеством пробелов, умноженным на текущую глубину. Отступ всегда состоит из пробелов, а не из табуляции.

Одна и та же функция с обеими настройками. Исходные данные: function total($items){$sum=0;foreach($items as $item){$sum+=$item["price"];}return $sum;}.

С 4 пробелами:

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

С 2 пробелами:

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

2 или 4 пробела

Четыре пробела обычная конвенция в проектах на PHP, и именно их требуют большинство руководств по стилю. Два пробела делают глубоко вложенный код уже, что удобно при вставке в небольшое поле тикета или сообщение в чате. Придерживайтесь того, что принято в вашей команде.

Что важно знать

• Табуляция во входных данных не сохраняется, так как пробелы вокруг фигурных скобок и точек с запятой пересоздаются.
• Отступы зависят только от фигурных скобок. Код, продолжающийся на нескольких строках внутри круглых скобок, например длинный массив, дополнительно не отступается.
• Фигурная скобка внутри комментария или heredoc тоже учитывается, и это может сдвинуть глубину для всего последующего кода.
• Несбалансированные фигурные скобки не отмечаются. Если закрывающие скобки закончились, глубина остается нулевой, и последующие строки не получают отступа.

Как исправить код, который потерял отступы

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

Проверьте результат

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