Laravel Verification

1---2name: laravel-verification3description: "Verification loop for Laravel projects: env checks, linting, static analysis, tests with coverage, security scans, and deployment readiness."4origin: ECC5---6 7# Laravel Verification Loop8 9Run before PRs, after major changes, and pre-deploy.10 11## When to Use12 13- Before opening a pull request for a Laravel project14- After major refactors or dependency upgrades15- Pre-deployment verification for staging or production16- Running full lint -> test -> security -> deploy readiness pipeline17 18## How It Works19 20- Run phases sequentially from environment checks through deployment readiness so each layer builds on the last.21- Environment and Composer checks gate everything else; stop immediately if they fail.22- Linting/static analysis should be clean before running full tests and coverage.23- Security and migration reviews happen after tests so you verify behavior before data or release steps.24- Build/deploy readiness and queue/scheduler checks are final gates; any failure blocks release.25 26## Phase 1: Environment Checks27 28```bash29php -v30composer --version31php artisan --version32```33 34- Verify `.env` is present and required keys exist35- Confirm `APP_DEBUG=false` for production environments36- Confirm `APP_ENV` matches the target deployment (`production`, `staging`)37 38If using Laravel Sail locally:39 40```bash41./vendor/bin/sail php -v42./vendor/bin/sail artisan --version43```44 45## Phase 1.5: Composer and Autoload46 47```bash48composer validate49composer dump-autoload -o50```51 52## Phase 2: Linting and Static Analysis53 54```bash55vendor/bin/pint --test56vendor/bin/phpstan analyse57```58 59If your project uses Psalm instead of PHPStan:60 61```bash62vendor/bin/psalm63```64 65## Phase 3: Tests and Coverage66 67```bash68php artisan test69```70 71Coverage (CI):72 73```bash74XDEBUG_MODE=coverage php artisan test --coverage75```76 77CI example (format -> static analysis -> tests):78 79```bash80vendor/bin/pint --test81vendor/bin/phpstan analyse82XDEBUG_MODE=coverage php artisan test --coverage83```84 85## Phase 4: Security and Dependency Checks86 87```bash88composer audit89```90 91## Phase 5: Database and Migrations92 93```bash94php artisan migrate --pretend95php artisan migrate:status96```97 98- Review destructive migrations carefully99- Ensure migration filenames follow `Y_m_d_His_*` (e.g., `2025_03_14_154210_create_orders_table.php`) and describe the change clearly100- Ensure rollbacks are possible101- Verify `down()` methods and avoid irreversible data loss without explicit backups102 103## Phase 6: Build and Deployment Readiness104 105```bash106php artisan optimize:clear107php artisan config:cache108php artisan route:cache109php artisan view:cache110```111 112- Ensure cache warmups succeed in production configuration113- Verify queue workers and scheduler are configured114- Confirm `storage/` and `bootstrap/cache/` are writable in the target environment115 116## Phase 7: Queue and Scheduler Checks117 118```bash119php artisan schedule:list120php artisan queue:failed121```122 123If Horizon is used:124 125```bash126php artisan horizon:status127```128 129If `queue:monitor` is available, use it to check backlog without processing jobs:130 131```bash132php artisan queue:monitor default --max=100133```134 135Active 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).136 137```bash138php artisan tinker --execute="dispatch((new App\\Jobs\\QueueHealthcheck())->onQueue('healthcheck'))"139php artisan queue:work --once --queue=healthcheck140```141 142Verify the job produced the expected side effect (log entry, healthcheck table row, or metric).143 144Only run this on non-production environments where processing a test job is safe.145 146## Examples147 148Minimal flow:149 150```bash151php -v152composer --version153php artisan --version154composer validate155vendor/bin/pint --test156vendor/bin/phpstan analyse157php artisan test158composer audit159php artisan migrate --pretend160php artisan config:cache161php artisan queue:failed162```163 164CI-style pipeline:165 166```bash167composer validate168composer dump-autoload -o169vendor/bin/pint --test170vendor/bin/phpstan analyse171XDEBUG_MODE=coverage php artisan test --coverage172composer audit173php artisan migrate --pretend174php artisan optimize:clear175php artisan config:cache176php artisan route:cache177php artisan view:cache178php artisan schedule:list179```