Форматувальник PHP
Форматуйте код PHP у послідовному, читабельному стилі за допомогою плагіна Prettier PHP, наближеного до конвенцій PSR-12. Вставте файл, що починається з <?php, і отримайте нормалізовані пробіли, фігурні дужки, масиви та ланцюжки методів, а також довгі списки аргументів, перенесені відповідно до заданої ширини друку. Про синтаксичні помилки повідомляється із зазначенням тексту помилки парсера, рядка й стовпця, що допомагає розробникам PHP упорядкувати застарілий код перед перевіркою.
Поширені запитання
Який форматувальник використовується?
Інструмент запускає Prettier 3 із @prettier/plugin-php 0.26 на сервері. Результат відповідає стилю, наближеному до PSR-12: за замовчуванням чотири пробіли на рівень, відкривні фігурні дужки класів і функцій — на окремому рядку, а кожен оператор — на власному рядку.
Чи потрібен у коді відкривний тег <?php?
Так. Плагін форматує код усередині тегів PHP. Усе поза ними вважається вбудованим HTML і залишається без змін, тож фрагмент без <?php повертається як є.
Які версії PHP підтримуються?
Сучасний синтаксис PHP 8 підтримується, зокрема атрибути, переліки, вирази match, стрілкові функції, іменовані аргументи, просування властивостей конструктора та класи лише для читання. Код для старіших версій PHP 5 і 7 також форматується.
Чи змінить форматувальник поведінку мого коду?
Ні. Він змінює лише оформлення. Можливі незначні косметичні переписування: наприклад, довгий синтаксис array() може замінитися еквівалентним коротким синтаксисом [], але поведінка коду залишиться незмінною.
Що станеться в разі синтаксичної помилки?
Форматування зупиниться, а інструмент покаже повідомлення парсера із зазначенням рядка та стовпця, наприклад про відсутню закривну дужку. Виправте це місце й запустіть форматування знову.
Чи можна використовувати табуляцію або два пробіли?
Так. Виберіть 2 або 4 пробіли чи ввімкніть табуляцію. Ширина друку від 40 до 200 символів, за замовчуванням 80, визначає, коли виклики, масиви та умови переносяться.
Чи зберігаються коментарі та блоки документації?
Так. Рядкові коментарі, блокові коментарі та блоки PHPDoc залишаються поруч із кодом, який вони описують. Їхній текст не переформатовується.
Чи може він форматувати шаблони, де змішані HTML та PHP?
Він форматує блоки PHP у таких шаблонах і залишає без змін фрагменти HTML між ними. Результат форматування великих файлів шаблонів усе ще може потребувати ручного доопрацювання.
Який обсяг коду можна форматувати за раз?
До 1 MB коду за запит; форматування зупиняється через 10 секунд. Цього вистачить навіть для дуже великих окремих файлів.
Чи зберігається мій код на сервері?
Ні. Код форматується в пам’яті й одразу повертається вам. Він не зберігається; у журналі фіксуються лише розміри запитів.