用途:为 Laravel 12.x(资料注明最新 12.69)升级到 Laravel 13(13.0 于 2026 年 3 月 17 日发布,当前稳定版 13.33)提供集中化升级路径。
主要能力与流程:升级前并行运行三个 Agent(explore-codebase 审计现有模式、research-expert 核对 13.x 升级文档、laravel-expert 应用最佳实践),升级后运行 sniper 校验。分五阶段:预升级审计、Composer 升级、破坏性变更修复、可选 Attributes 迁移、验证,多数项目总计不到 1 天。
必要用法:升级前须去掉 PHP 8.2 支持(PHP 8.3 为最低要求);先升开发依赖以尽早暴露测试失败。命令参考:composer require laravel/framework:^13.0 laravel/tinker:^3.0,composer require --dev phpunit/phpunit:^12.0 pestphp/pest:^4.0,composer update。中间件 VerifyCsrfToken 改为 PreventRequestForgery,需改 bootstrap/app.php 与别名。缓存前缀默认由下划线变连字符,如需保留旧行为可设置 CACHE_PREFIX、REDIS_PREFIX、SESSION_COOKIE。
限制与注意:不得在同一 Eloquent/Queue 类中混用 Attributes 与属性;使用 Beanstalkd 时不要忘记 pda/pheanstalk 版本;不要在模型 boot() 或 trait boot*() 中嵌套实例化(L13 会抛 LogicException);建议在功能分支上执行并先在 staging 验证。具体 12 项破坏性变更与完整命令序列见资料所述对应文档,未提供更多细节。