laravel-verification

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