mturac 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=falseonaylayı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/vebootstrap/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