Долгожданный ажиотаж наконец закончился, последнее приложение CLI с открытым исходным кодом Laravels было выпущено в мир, и мы получили его, чтобы рассказать вам все о нем. Представляем Пинту Laravel ...
Из файла 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
Откройте этот новый проект в своем терминале и установите пинту:
composer require laravel/pint --dev
Учитывая, что у нас есть совершенно новое приложение Laravel, давайте настроим пресет для Laravel. Создайте пинту.json и добавьте:
{
"preset": "laravel"
}
Теперь запустите пинту:
./vendor/bin/pint
Вы должны увидеть вывод, аналогичный приведенному ниже:
У нас старт 🚀
Теперь давайте изменим наш пресет на PSR-12 и проверим результат:
{
"preset": "psr12"
}
Снова запустите пинту и посмотрите, что вышло:
./vendor/bin/pint
Вы должны увидеть следующий вывод:
Давайте посмотрим на это немного.В нем реализованы такие правила, как single_trait_insert_per_statement
и braces
и new_with_braces
. Что, если мы хотим немного настроить их? Ну, мы можем очень легко включать и выключать правила, давайте отключим фигурные скобки в нашем файле pint.json:
{
"preset": "psr12",
"rules": {
"braces": false
}
}
Вот оно!Это так просто настроить, как вы хотите настроить свои стили кода, больше никакого беспорядочного PHP и массивов для настройки вашего стиля кодирования. Итак, давайте снова запустим пинту, но на этот раз мы хотим сделать пробный прогон, чтобы посмотреть, что изменится:
./vendor/bin/pint —test
Отлично, правда?