Composer如何升级Laravel 9到10依赖_Composer升级Laravel 9到10依赖实战-composer-PHP中文网

不能只改laravel/framework版本号再运行composer update，必须同步更新配套包、检查php（≥8.1）和composer（≥2.2）版本、迁移废弃api（如appserviceprovider::register、$dates属性、类式工厂）、修正配置结构（如logging.php）并清理缓存。

composer如何升级laravel 9到10依赖_composer升级laravel 9到10依赖实战

不能只改 laravel/framework 版本号再跑 composer update —— 这样大概率启动失败、中间件静默失效、模型工厂报错，甚至 php artisan serve 直接退出无提示。

确认 PHP 和 Composer 版本是否达标

Laravel 10 强制要求 PHP ≥ 8.1.0，Composer ≥ 2.2.0。不满足就卡在依赖解析阶段，报错类似：Your requirements could not be resolved 或 Root composer.json requires php ^8.1。

运行 php -v，若输出是 PHP 8.0.30 或更低，必须先升级 PHP
运行 composer --version，若低于 2.2.0，执行 composer self-update
检查 php artisan --version 确实是 Laravel Framework 9.x（不是 8.x 或 10.x）
别跳过第三方包兼容性检查：比如 laravel/sanctum 需 ≥ ^3.2，doctrine/dbal 需 ≥ ^3.0，否则 composer update 会回退或中断

修改 composer.json 的所有关键约束项

只改 "laravel/framework": "^9.0" → "laravel/framework": "^10.0" 是最常见错误。Laravel 10 的配套包必须同步更新，否则 AppServiceProvider::register() 被移除、$dates 属性被删等变更会直接导致运行时崩溃。

Laravel Creem Agent

Creem 支付商店助理 — 查询订阅、客户、交易、产品，执行心跳检查，管理本地 Laravel支付商店。

下载

批量替换以下字段（以 Laravel 10 官方 Upgrade Guide 为准）：
"laravel/framework": "^10.0"
"nunomaduro/collision": "^7.0"
"spatie/laravel-ignition": "^2.0"
"phpunit/phpunit": "^10.0"
"laravel/sanctum": "^3.2"
"doctrine/dbal": "^3.0"
删掉 "minimum-stability": "dev" 这类非稳定设置，改为 "minimum-stability": "stable"，防止意外装入 alpha/beta 包
删除 "phpunit/phpunit" 之外的测试相关扩展（如 phpunit-speedtrap），它们多数未适配 PHPUnit 10，会阻塞 composer update

执行更新并处理常见卡点

命令顺序和参数很关键。用错参数会导致部分子依赖没升、symfony 组件版本错位，进而引发 Class "Symfony\Component\Console\Command" not found 这类“找不到类”错误。

先运行 composer update "laravel/framework" "laravel/tinker" "laravel/sail" --with-all-dependencies（只升核心，避免连带污染）
如果卡在 doctrine/dbal，单独执行 composer require doctrine/dbal:^3.0 再重试
若报 symfony/console 兼容问题，手动锁死它："symfony/console": "^6.2"（对应 Laravel 10 兼容范围），再 composer update symfony/console
永远提交新的 composer.lock —— 它才是下次 composer install 的唯一依据，composer.json 只是“意向书”

升级后必须手动迁移的破坏性变更

Composer 只负责装包，不负责修代码。90% 的启动失败都源于这几处没动：

app/Providers/AppServiceProvider.php 中的 register() 方法已废弃，所有绑定逻辑必须移到 boot() 或服务容器配置文件中
config/logging.php 的 stack channel 结构重写，不要直接覆盖，要对比官方 v10 版本手动合并新增项（比如 channels 数组格式变化）
模型中的 $dates 属性完全移除，改用 $casts = ['published_at' => 'datetime']
模型工厂必须从类式写法（class PostFactory extends Factory）改为闭包式定义，否则 Post::factory()->create() 会报错
routes/web.php 若手动包裹了 Route::middleware('web')，Laravel 10 默认已自动包裹，重复应用会导致 session 丢失或 CSRF 失效

这些不是可选项，是 Laravel 10 启动前的硬性前提。漏掉任意一条，php artisan test 或真实请求里才会暴露，光看 composer update 成功没用。