Laravel升级需先确认PHP≥8.2、Composer≥2.5，再修改composer.json中"laravel/framework"为"^11.0"并执行composer update laravel/framework --with-all-dependencies，最后适配配置、清理缓存及验证功能。
Laragon 本身不直接升级 Laravel，它只是一个 Windows 下的本地开发环境套件（含 Apache/Nginx、MySQL、PHP、Composer 等）。真正升级 Laravel 框架的是 Composer —— 你只需在 Laragon 的终端（或系统 CMD/PowerShell）中，进入你的 Laravel 项目根目录，按标准 Composer 流程操作即可。
确认当前版本和环境要求
升级前先检查基础条件是否满足：
- 运行 php artisan --version 查看当前 Laravel 版本（如 v10.48.1）
- 运行 php -v 确认 PHP 版本：Laravel 11 要求 ≥ 8.2，Laravel 10 要求 ≥ 8.1
- 运行 composer --version 确保 Composer ≥ 2.5（Laravel 11 推荐），旧版可用
composer self-update升级 - 打开项目根目录下的 composer.json，找到
"laravel/framework"行，记下当前约束（如"^10.0"）
修改 composer.json 并执行更新
这是最关键的一步：Composer 不会跨主版本自动升级，必须手动改约束再更新。
- 将
"laravel/framework": "^10.0"改为"laravel/framework": "^11.0"（目标版本请以 官方文档为准） - 同时检查并更新配套依赖（Laravel 11 官方要求）：
"spatie/laravel-ignition": "^2.4""nunomaduro/collision": "^8.0""doctrine/dbal": "^4.0""phpunit/phpunit": "^10.5" - 删除
"minimum-stability": "dev"（如有），避免拉取不稳定分支 - 保存文件后，在项目根目录运行：
composer update laravel/framework --with-all-dependencies
升级后必做事项
命令执行成功不等于项目可运行，还需手动适配：
- 对照 Laravel 升级指南，检查废弃功能（如
Auth::basic、Model::unguard()）、配置变更（config/app.php新增项）、中间件调整等 - 运行 composer dump-autoload -o 重建类映射
- 清空 Laravel 缓存：
php artisan config:clearphp artisan cache:clearphp artisan view:clear - 如果使用 Sail 或其他工具，也需同步更新对应包（如
laravel/sail）
常见卡点与应对
遇到报错别硬扛，优先排查这几处：
-
“Your requirements could not be resolved”：大概率是 PHP 或 Composer 版本不足，或
composer.json中有冲突约束（如第三方包锁死旧版 Symfony） -
卡在 doctrine/dbal：先运行
composer require doctrine/dbal:^4.0落地基础版本，再重跑 update 命令 -
启动报 Class not found：删掉
vendor/和composer.lock，重新执行composer install（确保 lock 文件已更新） -
本地用 Laragon 启动失败：右键 Laragon → “Restart All”，确保 PHP 和 Web 服务加载了新环境；也可尝试用
php artisan serve快速验证
