Laravel 验证循环
在 PR 前、重大更改后以及部署前运行。
何时使用
- 为 Laravel 项目开启 Pull Request 前
- 重大重构或依赖升级后
- 预部署验证（用于 Staging 或 Production）
- 运行完整的：代码风格检查 -> 测试 -> 安全 -> 部署就绪流水线
工作原理
- 按阶段顺序执行，从环境检查到部署就绪，每个阶段基于上一阶段的结果。
- 环境和 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
如果你的项目使用 Psalm 而非 PHPStan：
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
- 确保在生产配置下缓存预热成功
- 验证队列工作者（Worker）和调度器（Scheduler）已配置
- 确认目标环境中的
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
主动验证（仅限 Staging）：将一个空操作作业分发到专用队列，并运行一个单次工作者进行处理（确保配置了非 sync 的队列连接）。
php artisan tinker --execute="dispatch((new App\Jobs\QueueHealthcheck())->onQueue('healthcheck'))"
php artisan queue:work --once --queue=healthcheck
验证作业是否产生了预期的副作用（日志条目、健康检查表行或指标）。
仅可在非生产环境中运行，此时处理测试作业是安全的。
示例
最小流程：
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