上线报 Composer platform check 失败 PHP 8.1 锁文件该怎么对齐

发版之后首页白屏,页面上只有一行 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 单独开分支验证。

您可以还会对下面的文章感兴趣: