Laravel Verification Loop

Run before PRs, after major changes, and pre-deploy.

When to Use

• Before opening a pull request for a Laravel project
• After major refactors or dependency upgrades
• Pre-deployment verification for staging or production
• Running full lint -> test -> security -> deploy readiness pipeline

How It Works

• Run phases sequentially from environment checks through deployment readiness so each layer builds on the last.
• Environment and Composer checks gate everything else; stop immediately if they fail.
• Linting/static analysis should be clean before running full tests and coverage.
• Security and migration reviews happen after tests so you verify behavior before data or release steps.
• Build/deploy readiness and queue/scheduler checks are final gates; any failure blocks release.

Phase 1: Environment Checks

bash
1php -v
2composer --version
3php artisan --version

• Verify .env is present and required keys exist
• Confirm APP_DEBUG=false for production environments
• Confirm APP_ENV matches the target deployment (production, staging)

If using Laravel Sail locally:

bash
1./vendor/bin/sail php -v
2./vendor/bin/sail artisan --version

Phase 1.5: Composer and Autoload

bash
1composer validate
2composer dump-autoload -o

Phase 2: Linting and Static Analysis

bash
1vendor/bin/pint --test
2vendor/bin/phpstan analyse

If your project uses Psalm instead of PHPStan:

bash
1vendor/bin/psalm

Phase 3: Tests and Coverage

bash
1php artisan test

Coverage (CI):

bash
1XDEBUG_MODE=coverage php artisan test --coverage

CI example (format -> static analysis -> tests):

bash
1vendor/bin/pint --test
2vendor/bin/phpstan analyse
3XDEBUG_MODE=coverage php artisan test --coverage

Phase 4: Security and Dependency Checks

bash
1composer audit

Phase 5: Database and Migrations

bash
1php artisan migrate --pretend
2php artisan migrate:status

• Review destructive migrations carefully
• Ensure migration filenames follow Y_m_d_His_* (e.g., 2025_03_14_154210_create_orders_table.php) and describe the change clearly
• Ensure rollbacks are possible
• Verify down() methods and avoid irreversible data loss without explicit backups

Phase 6: Build and Deployment Readiness

bash
1php artisan optimize:clear
2php artisan config:cache
3php artisan route:cache
4php artisan view:cache

• Ensure cache warmups succeed in production configuration
• Verify queue workers and scheduler are configured
• Confirm storage/ and bootstrap/cache/ are writable in the target environment

Phase 7: Queue and Scheduler Checks

bash
1php artisan schedule:list
2php artisan queue:failed

If Horizon is used:

bash
1php artisan horizon:status

If queue:monitor is available, use it to check backlog without processing jobs:

bash
1php artisan queue:monitor default --max=100

Active verification (staging only): dispatch a no-op job to a dedicated queue and run a single worker to process it (ensure a non-sync queue connection is configured).

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

Verify the job produced the expected side effect (log entry, healthcheck table row, or metric).

Only run this on non-production environments where processing a test job is safe.

Examples

Minimal flow:

bash
1php -v
2composer --version
3php artisan --version
4composer validate
5vendor/bin/pint --test
6vendor/bin/phpstan analyse
7php artisan test
8composer audit
9php artisan migrate --pretend
10php artisan config:cache
11php artisan queue:failed

CI-style pipeline:

bash
1composer validate
2composer dump-autoload -o
3vendor/bin/pint --test
4vendor/bin/phpstan analyse
5XDEBUG_MODE=coverage php artisan test --coverage
6composer audit
7php artisan migrate --pretend
8php artisan optimize:clear
9php artisan config:cache
10php artisan route:cache
11php artisan view:cache
12php artisan schedule:list