Форматувальник PHP

Що робить цей інструмент

Форматувальник PHP перетворює неохайний, мініфікований чи непослідовно відформатований PHP на чистий код за стандартом спільноти. Він підтримує сучасний синтаксис: типізовані та readonly-властивості, просування параметрів конструктора, стрілкові функції, enum, вирази match і атрибути.

Під капотом працює Prettier з офіційним плагіном PHP — та сама зв’язка, яку багато команд на Laravel і Symfony використовують у редакторах і pre-commit-хуках, тож результат збігається з тим, що видасть ваш інструментарій.

Як користуватися

1. Вставте PHP-код або відкрийте файл .php. Для коротких фрагментів відкривальний тег <?php необов’язковий.
2. Відформатований код з’являється праворуч під час набору.
3. Налаштуйте параметри:
   • Відступ: 4 пробіли — стандарт PSR; доступні також 2 пробіли й табуляція.
   • Ширина рядка: довші рядки переносяться там, де це дозволяє синтаксис.
   • Фігурні дужки: дужки класів і функцій на наступному рядку (PER / PSR-12) або на тому самому.
   • Версія PHP: найстаріша версія, на якій має працювати код.
   • Одинарні лапки та Кінцеві коми для багаторядкових списків.
4. Скопіюйте або збережіть результат.

Якщо в коді є синтаксична помилка, повідомлення вказує, що очікував парсер, а також рядок і стовпець, де він зупинився.

Приклад

Приклад — контролер у стилі Laravel, де все звалено докупи: груповий оператор use, масив-властивість, просування параметрів конструктора, виклик валідації, if в один рядок і array_map зі стрілковою функцією. Після форматування фігурна дужка кожного методу переходить на окремий рядок, оператори й => отримують пробіли, тіло if розгортається, а довгі виклики response()->json() переносяться по одному елементу масиву на рядок із кінцевими комами.

Чого форматувальник не змінює

Форматувальник змінює лише розмітку коду. Він не перейменовує змінні, не впорядковує оператори use, не перетворює array() на короткий синтаксис і не виправляє логіку. Коментарі, зокрема блоки PHPDoc, зберігаються й отримують відступи разом із навколишнім кодом.

Поради

• Використовуйте ту саму ширину рядка й версію PHP, що й у конфігурації Prettier або PHP-CS-Fixer вашого проєкту, щоб уникнути зайвих змін у диффах.
• Фрагмент, скопійований із логу чи стек-трейсу, після форматування читати значно легше.
• Якщо ділитеся кодом в issue, спершу відформатуйте його, щоб рецензенти могли зосередитися на суті.