pretty-php — форматтер кода PHP с пресетом WordPress

28 октября 2025

В редакторе VS Code появилось расширение, интегрирующее последний релиз pretty-php — быстрого, детерминированного и минимально настраиваемого форматтера PHP, созданного по принципам Black. Инструмент фокусируется на читаемости и малых диффах, чтобы код выглядел одинаково в любых проектах, включая WordPress и WooCommerce.

Ключевые возможности

Поддержка PHP до 8.4 (включая property hooks) при наличии совместимой версии PHP на системе.
Форматирование ради читаемости, согласованности и небольших диффов; предыдущее форматирование игнорируется.
Меняются только пробелы и переносы строк (есть точечно задокументированные исключения).
Форматируется весь файл «на месте», опции намеренно ограничены.
Проверяется эквивалентность исходного и отформатированного кода.
Совместимость с PSR-12 и PER, есть пресеты для Symfony, Drupal, Laravel и WordPress.
Работает из VS Code, с командной строки и в CI; легко сочетается с линтерами.

Конфигурация

Настройка доступна через параметры расширения VS Code или через файл проекта.

Если найден .prettyphp или prettyphp.json, настройки VS Code игнорируются.
Доступна команда расширения для автогенерации конфигурации;
Встроенная схема JSON упрощает редактирование через IntelliSense.

Минимальный пример

{
  "src": ["."]
}

PSR-12/PER и выборочные пути

{
  "src": ["bin", "src", "tests/unit", "bootstrap.php"],
  "includeIfPhp": true,
  "psr12": true
}

Прагматизм

pretty-php в целом следует своим собственным правилам («предыдущее форматирование игнорируется, изменяются только пробельные символы»), но иногда делаются исключения, например:

Некоторые переводы строк сохраняются: Переводы строк, смежные с большинством операторов, разделителей и скобок, копируются из входных данных в выходные (подробности см. в разделе Переводы строк).Настройка «Formatting: Operator Placement» может быть использована для изменения этого поведения, или для временного подавления используйте команду «Format PHP without Preserving Newlines».
Строки и числа нормализуются: Строки в одинарных кавычках предпочтительны, если только альтернатива не короче или не требуются экранирующие обратные слэши.Используйте настройки «Formatting: Simplify Strings» и «Formatting: Simplify Numbers», чтобы отключить или изменить это поведение.
Импорты группируются и сортируются по имени, сначала в глубину: Настройка «Formatting: Sort Imports By» может быть использована для отключения или изменения этого поведения.
Комментарии перемещаются при необходимости для правильного размещения смежных токенов: Отключите настройку «Formatting: Move Comments», чтобы отключить это поведение.
Комментарии рядом с кодом не переносятся на следующую строку
Комментарии обрезаются и выравниваются
Пустые DocBlocks удаляются