laravel-verification

name	laravel-verification
description	Laravel 프로젝트를 위한 검증 루프입니다. 환경 점검, 린트, 정적 분석, 커버리지 포함 테스트, 보안 점검, 배포 준비 상태를 확인합니다.
origin	ECC

Laravel 검증 루프

PR 생성 전, 큰 변경 후, 배포 전에 실행합니다.

사용 시점

• Laravel 프로젝트에서 pull request를 열기 전
• 대규모 리팩터링이나 의존성 업그레이드 이후
• 스테이징 또는 운영 배포 전 검증
• 전체 lint -> test -> security -> deploy readiness 파이프라인을 돌릴 때

동작 방식

• 환경 점검부터 배포 준비 상태까지 단계를 순차적으로 실행하며, 각 단계는 이전 단계의 성공을 전제로 합니다.
• 환경과 Composer 점검은 다른 모든 단계의 선행 조건이므로 실패 시 즉시 중단합니다.
• 전체 테스트와 커버리지를 실행하기 전에 린트와 정적 분석이 깨끗해야 합니다.
• 보안 및 마이그레이션 검토는 테스트 이후에 수행해, 데이터 변경이나 릴리스 단계 전에 동작을 검증합니다.
• 빌드/배포 준비 상태와 큐/스케줄러 점검은 마지막 게이트이며, 여기서 실패하면 릴리스를 막아야 합니다.

1단계: 환경 점검

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

• .env가 존재하고 필수 키가 있는지 확인합니다.
• 운영 환경에서는 APP_DEBUG=false인지 확인합니다.
• APP_ENV가 대상 배포 환경(production, staging)과 일치하는지 확인합니다.

로컬에서 Laravel Sail을 사용 중이라면:

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

1.5단계: Composer 및 오토로드

composer validate
composer dump-autoload -o

2단계: 린트 및 정적 분석

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

프로젝트가 PHPStan 대신 Psalm을 사용한다면:

vendor/bin/psalm

3단계: 테스트 및 커버리지

php artisan test

커버리지(CI):

XDEBUG_MODE=coverage php artisan test --coverage

CI 예시(포맷 -> 정적 분석 -> 테스트):

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

4단계: 보안 및 의존성 점검

composer audit

5단계: 데이터베이스 및 마이그레이션

php artisan migrate --pretend
php artisan migrate:status

• 파괴적 마이그레이션은 특히 신중히 검토합니다.
• 마이그레이션 파일명이 Y_m_d_His_* 형식을 따르는지 확인합니다. 예: 2025_03_14_154210_create_orders_table.php
• 롤백이 가능한지 확인합니다.
• 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

Horizon을 사용한다면:

php artisan horizon:status

queue:monitor를 사용할 수 있다면, 작업을 처리하지 않고 백로그를 점검하는 데 사용합니다.

php artisan queue:monitor default --max=100

능동 검증(스테이징 전용): 전용 큐에 no-op 작업을 발행하고 단일 워커로 처리해 봅니다. sync가 아닌 큐 연결이 설정돼 있어야 합니다.

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

작업이 예상된 부수 효과(로그 항목, 헬스체크 테이블 row, 메트릭)를 남겼는지 확인합니다.

테스트 작업을 처리해도 안전한 비운영 환경에서만 실행합니다.

예시

최소 흐름:

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 스타일 파이프라인:

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