composer update 默认不是“更新”,而是丢弃 composer.lock、按 composer.json 重算整棵依赖图,可能引发静默行为变更;应优先用 composer outdated 评估,再谨慎操作并提交 composer.lock。
composer
update 默认不是“更新”,是“重算依赖图”
直接跑
不会安全地升级现有包,而是丢掉
,重新读取
中所有版本约束,从 Packagist 拉取当前满足条件的最新版——哪怕只是
,也可能触发底层行为变更:HTTP 超时缩短、日志字段名改名、断言匹配逻辑收紧。这些不会报错,但会在运行时静默出问题。
常见错误现象:
后本地能跑、CI 通过,上线后某个接口超时或日志格式崩了——不是代码写错了,是依赖重算后默认拿了新行为。
生产环境禁止无参数执行
CI/CD 流水线必须用
,否则每次构建拉的版本可能不同,破坏可重现性
本地开发想尝新,也应先
或切分支,再操作
只升一个包,但子依赖卡在旧版?用 --with-dependencies
默认只更新
本身,它依赖的
或
仍按
里旧 SHA 安装。这容易导致 PHP 8.2 下类加载失败,或安全漏洞没被连带修复。
正确做法是显式带上依赖链:
:更新该包 + 它**直接声明**的依赖(如
)
:递归更新整个依赖子图,包括间接依赖(如
的依赖
扩展要求)
注意:如果其他包硬锁了同一依赖的旧版(比如
锁
),
会直接报冲突,而非跳过
想升主版本(如 Laravel 9 → 10)?别指望 update 自动完成
显示
,不等于
就能成功。Composer 会严格检查约束兼容性,而 Laravel 10 要求
、
、
—— 只要其中任一条件不满足,命令立刻退出并报错。
实操路径很明确:
Composer 2.9.6
Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化,改进了依赖解析算法,提升大型项目中的安装与更新速度。它支持并行下载任务,显著减少等待时间,并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷,确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护,Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。
下载
先手动改
:把
改成
同步调整平台要求:
运行
,看哪个包在拦路(常是第三方插件锁死
)
确认无阻塞后,再执行
漏掉
,很可能只升了
,而
还卡在 9.x,直接报
。
全局包更新和 Composer 自身升级不是一回事
很多人混淆三件事:
更新的是你用
装的命令行工具(如
、
);
升级的是 Composer 本体;而项目里的
管的是
下的运行时依赖。
关键区别:
读的是
,影响所有项目的全局命令,升级前建议先
看哪些是你主动装的
仅适用于官方安装方式(
),用
或
装的必须走对应包管理器,且往往滞后
升级 Composer 本体后,务必验证:
输出不能含
或
,否则得立刻
最易忽略的一点:PHP 版本升级(如从 8.1 升到 8.2)后,必须重新跑
(哪怕没改
),否则
可能因平台不兼容失败——因为 Composer 会按当前 PHP 版本过滤可用包版本,而
里还记着旧版的 SHA。
composer updatecomposer.lockcomposer.json7.9.1 → 7.9.2composer updatecomposer updatecomposer installgit stashcomposer update monolog/monologmonolog/monologpsr/logsymfony/polyfill-php80composer.lockcomposer update monolog/monolog --with-dependencies"psr/log": "^1.1"composer update monolog/monolog --with-all-dependenciespsr/logphplaravel/frameworksymfony/event-dispatcher ^5.4--with-all-dependenciescomposer outdatedlaravel/framework 9.52.15 → 10.38.1composer update laravel/frameworkphp >= 8.1symfony/console >= 6.3phpunit/phpunit >= 10composer.json"laravel/framework": "^9.0""^10.0""platform": {"php": "8.2"}composer why-not laravel/framework:10.*symfony/*composer update laravel/framework --with-all-dependencies--with-all-dependencieslaravel/frameworkilluminate/supportClass not foundcomposer global updatecomposer global requirelaravel/installerphpunit/phpunitcomposer self-updatecomposer updatevendor/composer global update~/.composer/composer.jsoncomposer global show --directcomposer self-updatecurl | phpbrewaptcomposer --versionsnapshotbetacomposer self-update --rollbackcomposer updatecomposer.jsoncomposer installcomposer.lock