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