Długo oczekiwany pociąg do szumu wreszcie się skończył, najnowsza aplikacja CLI Laravels o otwartym kodzie źródłowym została wydana światu i dotarliśmy do niej, aby opowiedzieć Ci o niej wszystko. Przedstawiamy Laravel Pint ...
Z readme „Laravel pint to narzędzie do naprawy kodu PHP o zerowej zależności dla minimalistów – oparte na PHP-CS-Fixer”.
Gdy tylko to przeczytałem, byłem podekscytowany, to znaczy bardzo podekscytowany. We współczesnym PHP przeszliśmy przez fazę doskonalenia naszego rzemiosła, czyniąc nasz kod bardziej restrykcyjnym i lepiej testowanym oraz upewniając się, że mamy spójny styl kodu.Wszystko zaczęło się, gdy powstał PHP-FIG i zaczęli wypuszczać PSR-y, a to rosło w siłę dzięki frameworkom, które miały własne, specyficzne reguły publikowanych stylów. Ten pakiet nie jest inny, automatycznie przetestuje i naprawi twój styl kodu w oparciu o gotowe ustawienia.
Aby rozpocząć korzystanie z tego pakietu, zainstaluj go za pomocą kompozytora:
composer require laravel/pint --dev
Po zainstalowaniu będzie działać bez konieczności konfiguracji. Możesz więc uruchomić:
./vendor/bin/pint
Bez konfiguracji, konfiguracji, myślenia i wysiłku — mój projekt jest natychmiast oceniany pod kątem stylizacji PSR-12 i automatycznie naprawiany. Absolutnie magiczny.Utrzymanie czystego i spójnego kodu czasami wymaga wysiłku lub przemyślenia, jak to zrobić – jakie reguły musisz zaimplementować. Lub za pomocą PHP CS Fixer musiałeś utworzyć plik konfiguracyjny, a następnie przejść i utworzyć wyszukiwarkę, aby dodać reguły do pliku PHP w tablicy. Sprawy szybko się pomieszały, prawda?
Nigdy więcej. Jeśli stworzysz kufel.json w katalogu głównym twojego projektu, po prostu go załaduje i odczyta konfigurację - w przeciwnym razie pozostanie przy swoich ustawieniach domyślnych. Fakt, że cała konfiguracja odbywa się przy użyciu JSON, sprawi, że będzie to znacznie łatwiejsze w użyciu i bardziej czytelne.
Rzućmy okiem na konfigurowanie nowej konfiguracji kufla za pomocą gotowych ustawień.Ale spójrzmy, jak zrobić to z nowym, świeżym projektem Laravel, więc utwórz nowy projekt:
laravel new pint-demo
Otwórz ten nowy projekt w swoim terminalu i zainstaluj pint:
composer require laravel/pint --dev
Mając na uwadze, że mamy zupełnie nową aplikację Laravel, skonfigurujmy ustawienia wstępne dla Laravela. Utwórz piwo.plik json i dodaj:
{
"preset": "laravel"
}
Teraz uruchom kufel:
./vendor/bin/pint
Powinieneś zobaczyć wynik podobny do poniższego:
Wystartowaliśmy 🚀
Więc zmieńmy teraz nasze ustawienie wstępne na PSR-12 i sprawdźmy dane wyjściowe:
{
"preset": "psr12"
}
Uruchom ponownie kufel i zobaczmy wynik:
./vendor/bin/pint
Powinieneś zobaczyć następujące dane wyjściowe:
Przyjrzyjmy się temu trochę.Ma zaimplementowane reguły, takie jak single_trait_insert_per_statement
i braces
oraz new_with_braces
. A co, jeśli chcemy je trochę dostosować? Cóż, możemy naprawdę łatwo włączać i wyłączać reguły, wyłączmy nawiasy klamrowe w naszym pliku pint.json:
{
"preset": "psr12",
"rules": {
"braces": false
}
}
To jest to!To tak proste, aby dostosować sposób, w jaki chcesz skonfigurować style kodu, koniec z niechlujnym PHP i tablicami do konfiguracji stylu kodowania. Więc spróbujmy jeszcze raz, ale tym razem chcemy zrobić próbę, aby zobaczyć, co się zmieni:
./vendor/bin/pint —test
Niesamowite, prawda?