Довгоочікуваний поїзд ажіотажу нарешті закінчився. Останній додаток CLI з відкритим кодом Laravels випущено у світ, і ми отримали його, щоб розповісти вам все про нього. Представляємо Laravel Pint ...
З readme "Laravel pint — це засіб для виправлення стилю PHP-коду без залежності для мінімалістів, побудований на основі PHP-CS-Fixer".
Як тільки я прочитав це, я був схвильований, і я маю на увазі дуже схвильований. У сучасному PHP ми проходили етап відточування нашої майстерності, роблячи наш код суворішим і краще тестованим, а також переконавшись, що ми маємо послідовний стиль коду.Все це почалося ще тоді, коли був сформований PHP-FIG, і вони почали випускати PSR, і це зміцнювалося з фреймворками, які мали власні опубліковані правила стилю. Цей пакет нічим не відрізняється, він автоматично перевірить і виправить стиль вашого коду на основі попереднього налаштування.
Щоб розпочати роботу з цим пакетом, встановіть його за допомогою composer:
composer require laravel/pint --dev
Після встановлення він буде працювати без необхідності налаштування. Тож ви можете запустити:
./vendor/bin/pint
Без конфігурації, без налаштування, без роздумів чи зусиль – мій проект миттєво оцінюється на предмет стилю PSR-12 та автоматично виправляється. Абсолютно чарівні.Щоб підтримувати ваш код чистим і послідовним, іноді потрібні зусилля або роздуми над тим, як це налаштувати – які правила вам потрібно впровадити. Або за допомогою PHP CS Fixer вам потрібно було створити файл конфігурації, потім пройти і створити засіб пошуку, щоб додати правила до файлу PHP в масиві. Все швидко заплуталося?
Більше нічого. Якщо ви створюєте пінту.json у корені вашого проекту, він просто завантажить його та прочитає конфігурацію – інакше дотримуйтеся значень за замовчуванням. Той факт, що вся конфігурація виконується за допомогою JSON, також спрощує використання та читабельність.
Давайте швидко розглянемо налаштування нової конфігурації пінти за допомогою попереднього налаштування.Але давайте подивимося, як це зробити за допомогою нового проекту Laravel, тому створіть новий проект:
laravel new pint-demo
Відкрийте цей новий проект у своєму терміналі та встановіть pint:
composer require laravel/pint --dev
Враховуючи, що у нас є абсолютно новий додаток Laravel, давайте налаштуємо попередні налаштування на Laravel. Створіть пінту.json і додайте:
{
"preset": "laravel"
}
Тепер запустіть pint:
./vendor/bin/pint
Ви повинні побачити результат, подібний до наведеного нижче:
У нас старт 🚀
Тож давайте тепер змінимо наш пресет на PSR-12 і перевіримо вихід:
{
"preset": "psr12"
}
Запустіть pint ще раз і подивимося на результат:
./vendor/bin/pint
Ви повинні побачити такий результат:
Давайте трохи перевіримо це.Він реалізував такі правила, як single_trait_insert_per_statement
і дужки
і new_with_braces
. Що, якщо ми хочемо трохи налаштувати їх? Ми можемо легко вмикати та вимикати правила, давайте вимкнемо фігурні дужки у нашому файлі pint.json:
{
"preset": "psr12",
"rules": {
"braces": false
}
}
Ось і все!Це так просто, щоб налаштувати, як ви хочете налаштувати стилі коду, більше немає брудного PHP і масивів для налаштування стилю кодування. Тож давайте знову запустимо pint, але цього разу ми хочемо зробити сухий запуск, щоб побачити, що буде змінено:
./vendor/bin/pint —test
Чудово?