PHP升级后composer install报错需先执行composer clear-cache再运行composer update --with-all-dependencies,以强制重算全部依赖兼容性,否则旧lock文件中的不兼容包会导致运行时错误。

Composer 不会自动检测 PHP 版本或扩展变更,也不会主动校验已锁依赖是否仍兼容新环境。它只在 composer update 或首次生成 composer.lock 时做一次平台兼容性解析,之后就完全信任 lock 文件里的结果。
PHP 升级后 composer install 直接报错怎么办
常见现象是执行 composer install 时抛出 Your requirements could not be resolved to an installable set of packages.,但 php -v 明明已是目标版本,composer.json 里也写了 "php": "^8.2"。
根本原因是 Composer 缓存了旧 PHP 版本下解出的依赖组合,而 install 不触发重解析——它只按 lock 文件装包,不管当前 PHP 是否还支持这些包里的函数或扩展。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 必须先运行
composer clear-cache清掉平台感知缓存 - 再执行
composer update --with-all-dependencies,强制重算整个依赖图(包括传递依赖) - 跳过
clear-cache或只用composer update(无参数)都可能漏掉间接依赖的兼容性问题
为什么 --with-all-dependencies 比普通 update 更关键
普通 composer update 只放开 composer.json 顶层 require 的包,而像 symfony/console 这类被 laravel/framework 引入的间接依赖,会被死锁在 lock 文件旧版本里——哪怕它自己早已支持 PHP 8.2,Composer 也不会主动升级。
-
composer update vendor/package:只更新指定包及其直接依赖 -
composer update --with-dependencies vendor/package:更新该包 + 它所依赖的包(一层深度) -
composer update --with-all-dependencies:递归放开所有层级的版本锁,确保每个包都满足当前 PHP 平台约束 - 漏掉
--with-all-dependencies是老项目升 PHP 后运行时报Call to undefined function的最常见原因
升级前必须确认的三件事
别只盯着 composer.json 和版本号,实际运行失败往往卡在底层支撑上。
- 运行
php -m检查扩展是否齐全,尤其mbstring、curl、json、openssl;缺一个就可能导致guzzlehttp/guzzle或ext-json相关包安装失败 - 用
composer check-platform-reqs验证当前 PHP 环境是否满足所有已锁包的require字段(如"ext-mbstring": "*") - 确认 CI 流水线使用的 Composer 版本与本地一致;
composer.lock被高版本 Composer 写入后,低版本可能无法读取(报Your lock file does not contain a compatible set of packages)
真正容易被忽略的是:即使你做了全部操作,某些包的兼容性问题仍藏在运行时——比如一个依赖悄悄要求 ext-gmp,但没写进自己的 composer.json,只在代码里 function_exists('gmp_init') 后调用。这类问题只能靠 php -d extension=xxx.php index.php 逐个验证扩展可用性,而不是依赖 Composer 的静态检查。

















