Laravel Project Verification

Обеспечьте качество кода Laravel с навыком laravel-verification для Claude Code. Автоматизируйте тесты, линтинг, проверки безопасности и развертывания в одном цикле.

Безопасность и тестирование ★ 172,009 GitHub (172,009 ★)

Этот навык предоставляет структурированный многофазный процесс верификации, созданный для Laravel-разработчиков, чтобы обеспечить качество кода и безопасность развертывания. Он направляет Claude через валидацию окружения, статический анализ с помощью Pint и PHPStan, автоматизированное тестирование с отчетами о покрытии, сканирование уязвимостей безопасности через Composer и проверки готовности к продакшену, такие как кеширование роутов и конфигов. Это незаменимый инструмент для разработчиков, стремящихся стандартизировать свои предварительные проверки перед открытием Pull Request или слиянием в продакшен-ветки, гарантируя, что каждое изменение соответствует высочайшим стандартам стабильности и безопасности.

Ключевые возможности

01172 009 звезд на GitHub

02Встроенный статический анализ и проверка стиля кода с помощью Pint, PHPStan или Psalm.

03Автоматизированный запуск тестов с поддержкой покрытия через Xdebug.

04Последовательные фазы верификации: от проверок окружения до готовности к развертыванию.

05Проверка безопасности миграций базы данных и оптимизация кеша для продакшена.

06Аудит безопасности и сканирование уязвимостей зависимостей через Composer.

Варианты использования

01Валидация масштабных рефакторингов или обновлений крупных зависимостей.

02Аудит готовности к развертыванию на стейджинге и в продакшене.

03Проверка качества кода и регрессионное тестирование перед Pull Request.

Error in user YAML: (<unknown>): mapping values are not allowed in this context at line 2 column 52

---
name: laravel-verification
description: Verification loop for Laravel projects: env checks, linting, static analysis, tests with coverage, security scans, and deployment readiness.
origin: ECC
---

Laravel Doğrulama Döngüsü

PR'lardan önce, büyük değişikliklerden sonra ve deployment öncesi çalıştırın.

Ne Zaman Kullanılır

Laravel projesi için pull request açmadan önce
Büyük refactoring'ler veya bağımlılık yükseltmelerinden sonra
Staging veya production için deployment öncesi doğrulama
Tam lint -> test -> güvenlik -> deployment hazırlık pipeline'ı çalıştırma

Nasıl Çalışır

Her katmanın bir öncekinin üzerine inşa edilmesi için fazları sırayla ortam kontrollerinden deployment hazırlığına kadar çalıştırın.
Ortam ve Composer kontrolleri her şeyi kapsar; başarısız olurlarsa hemen durun.
Tam testleri ve kapsamı çalıştırmadan önce linting/static analiz temiz olmalıdır.
Güvenlik ve migration incelemeleri testlerden sonra olur, böylece veri veya yayın adımlarından önce davranışı doğrularsınız.
Build/deployment hazırlığı ve kuyruk/zamanlayıcı kontrolleri son kapılardır; herhangi bir başarısızlık yayını engeller.

Faz 1: Ortam Kontrolleri

php -v
composer --version
php artisan --version

.env'nin mevcut olduğunu ve gerekli anahtarların var olduğunu doğrulayın
Production ortamları için APP_DEBUG=false onaylayın
APP_ENV'in hedef deployment'la eşleştiğini onaylayın (production, staging)

Yerel olarak Laravel Sail kullanıyorsanız:

./vendor/bin/sail php -v
./vendor/bin/sail artisan --version

Faz 1.5: Composer ve Autoload

composer validate
composer dump-autoload -o

Faz 2: Linting ve Static Analiz

vendor/bin/pint --test
vendor/bin/phpstan analyse

Projeniz PHPStan yerine Psalm kullanıyorsa:

vendor/bin/psalm

Faz 3: Testler ve Kapsam

php artisan test

Kapsam (CI):

XDEBUG_MODE=coverage php artisan test --coverage

CI örneği (format -> static analiz -> testler):

vendor/bin/pint --test
vendor/bin/phpstan analyse
XDEBUG_MODE=coverage php artisan test --coverage

Faz 4: Güvenlik ve Bağımlılık Kontrolleri

composer audit

Faz 5: Database ve Migration'lar

php artisan migrate --pretend
php artisan migrate:status

Yıkıcı migration'ları dikkatle inceleyin
Migration dosya isimlerinin Y_m_d_His_* formatını takip ettiğinden emin olun (örn. 2025_03_14_154210_create_orders_table.php) ve değişikliği net bir şekilde açıklasın
Rollback'lerin mümkün olduğundan emin olun
down() metotlarını doğrulayın ve açık yedeklemeler olmadan geri alınamaz veri kaybından kaçının

Faz 6: Build ve Deployment Hazırlığı

php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache

Cache warmup'larının production yapılandırmasında başarılı olduğundan emin olun
Kuyruk worker'larının ve zamanlayıcının yapılandırıldığını doğrulayın
Hedef ortamda storage/ ve bootstrap/cache/'in yazılabilir olduğunu onaylayın

Faz 7: Kuyruk ve Zamanlayıcı Kontrolleri

php artisan schedule:list
php artisan queue:failed

Horizon kullanılıyorsa:

php artisan horizon:status

queue:monitor mevcutsa, job'ları işlemeden biriktirmeyi kontrol etmek için kullanın:

php artisan queue:monitor default --max=100

Aktif doğrulama (sadece staging): özel bir kuyruğa no-op job dispatch edin ve işlemek için tek bir worker çalıştırın (non-sync kuyruk bağlantısının yapılandırıldığından emin olun).

php artisan tinker --execute="dispatch((new App\\Jobs\\QueueHealthcheck())->onQueue('healthcheck'))"
php artisan queue:work --once --queue=healthcheck

Job'un beklenen yan etkiyi ürettiğini doğrulayın (log girişi, healthcheck tablo satırı veya metrik).

Bunu sadece test job'u işlemenin güvenli olduğu non-production ortamlarında çalıştırın.

Örnekler

Minimal akış:

php -v
composer --version
php artisan --version
composer validate
vendor/bin/pint --test
vendor/bin/phpstan analyse
php artisan test
composer audit
php artisan migrate --pretend
php artisan config:cache
php artisan queue:failed

CI tarzı pipeline:

composer validate
composer dump-autoload -o
vendor/bin/pint --test
vendor/bin/phpstan analyse
XDEBUG_MODE=coverage php artisan test --coverage
composer audit
php artisan migrate --pretend
php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan schedule:list

Что это 🔍

Laravel Project Verification — это многофазный пайплайн проверки Laravel-проектов, который объединяет контроль окружения, линтинг, статический анализ, тесты с покрытием, аудит безопасности, проверку миграций и подготовку к деплою. Навык предназначен для автоматизации валидации перед Pull Request'ами, после крупных изменений или непосредственно перед выкладкой на staging/production.

Как работает ⚙️

Пайплайн состоит из семи последовательных фаз. Каждая фаза опирается на успешное прохождение предыдущей — если что-то падает, процесс останавливается.

Фаза 1: Проверка окружения 🖥️

Первым делом проверяются версии PHP (php -v), Composer (composer --version) и фреймворка (php artisan --version). Затем:

Убеждаемся, что файл .env существует и содержит все необходимые ключи.
Для production окружения APP_DEBUG должен быть false, а APP_ENV — соответствовать целевому окружению (production, staging).
Если используется Laravel Sail, команды выполняются через ./vendor/bin/sail.

Фаза 1.5: Composer и автозагрузка 📦

Выполняется composer validate (проверка composer.json) и composer dump-autoload -o (оптимизация автозагрузчика).

Фаза 2: Линтинг и статический анализ ✨

Запускаются vendor/bin/pint --test (Laravel Pint) для проверки стиля кода и vendor/bin/phpstan analyse для статического анализа. Если проект использует Psalm вместо PHPStan, запускается vendor/bin/psalm.

Фаза 3: Тесты и покрытие 🧪

Выполняется php artisan test (или XDEBUG_MODE=coverage php artisan test --coverage для получения отчёта о покрытии). Тесты должны быть зелёными, иначе дальнейшие фазы не запускаются.

Фаза 4: Безопасность 🛡️

composer audit проверяет зависимости на известные уязвимости. Если найдены проблемы — пайплайн останавливается.

Фаза 5: Миграции базы данных 🗄️

Имитация миграций через php artisan migrate --pretend и проверка статуса php artisan migrate:status. Особое внимание уделяется деструктивным миграциям (удаление полей/таблиц), их нужно проверять вручную. Также проверяется, что файлы миграций следуют формату Y_m_d_His_* и имеют понятные имена, а down() методы реализованы безопасно.

Фаза 6: Подготовка к деплою 🚀

Очистка старого кэша и прогрев нового:

php artisan optimize:clear
php artisan config:cache
php artisan route:cache
php artisan view:cache

Проверяется, что директории storage/ и bootstrap/cache/ доступны для записи.

Фаза 7: Очереди и планировщик ⏰

Просмотр запланированных задач (php artisan schedule:list) и списка упавших задач очереди (php artisan queue:failed). Если используется Laravel Horizon, проверяется его статус (php artisan horizon:status). Для проверки работоспособности очереди (только на staging) можно отправить тестовый job и обработать его через queue:work --once.

Когда использовать ✅

Перед открытием Pull Request'а в Laravel-проекте.
После крупного рефакторинга или обновления зависимостей.
Перед деплоем на staging или production.
В CI/CD как единый пайплайн проверки качества.

Важно знать ⚠️

Пайплайн последовательный: если одна из фаз завершается с ошибкой, процесс прерывается. Это позволяет быстро выявить проблему на раннем этапе.
Для локальной разработки с Laravel Sail используйте команды через ./vendor/bin/sail.
Фаза 7 с тестовым job'ом предназначена только для non-production окружений.
В навыке приведены два типовых сценария: минимальный (все фазы, но без покрытия) и CI-стиль (с покрытием и полным набором). Вы можете адаптировать последовательность под свой проект.

Установка одной командой.

npx skillfish add affaan-m/everything-claude-code laravel-verification

Источник: https://mcpmarket.com/tools/skills/laravel-project-verification-1