发版之后首页白屏,页面上只有一行 Composer detected issues in your platform: Your Composer dependencies require a PHP version ">= 8.2.0". You are running 8.1.27. 生产机的 PHP 一直是 8.1,之前跑同一份代码没事,这次动了依赖才炸。
追下去,报错来自 vendor/composer/platform_check.php。Composer 2 在 dump-autoload 时会生成这个文件,autoload 一加载就做版本判断,不满足直接 exit。第一反应是删掉它,删完页面能开,下次 composer install 又生成回来,治标不治本。
根因是开发机 8.2、生产机 8.1。开发机跑 composer require 时,Composer 按本机 PHP 算依赖,选中的包要求 php >= 8.2,lock 里就写死了。生产机照着 lock 装,平台不匹配。
试过直接在生产机上 composer update,让它按 8.1 重新解析。跑了半小时,几十个包全升了大版本,测试环境红一片,只能回滚。
正解是在 composer.json 里声明平台版本,让 Composer 假装跑在 8.1 上。config.platform.php 写 8.1.27,之后所有解析和检查都按这个算,lock 也不会再要求 8.2。
"config": {
"platform": {
"php": "8.1.27"
}
}
composer update --with-all-dependencies
composer check-platform-reqs
改完必须重新生成 lock,只跑 dump-autoload 不够。用 update --with-all-dependencies 把受影响的包一并降级,否则 lock 里已有的 8.2 包不会被重新评估。
验证分三步。生产机 php -v 确认 8.1.27,check-platform-reqs 全绿,页面能开。CI 里的 PHP 也锁到 8.1,避免下次有人在 8.2 上提交 lock。
副作用也有。声明 platform 之后本地想试 8.3 新特性就不行了,Composer 一直按 8.1 解析。团队的做法是本地也装 8.1 跑测试,8.3 单独开分支验证。
