Composer 指定依赖解析的 PHP 版本

使用 config.platform.php 按目标 PHP 版本解析依赖,并检查真实运行环境是否兼容。

指定目标 PHP 版本

当开发环境与部署环境的 PHP 版本不同时,可以让 Composer 按部署环境解析依赖。下面以历史项目的 PHP 7.2.34 为例,版本值应替换为实际目标版本。

在现有 composer.json 的 config 中合并以下设置:

1
2
3
4
5
6
7
{
  "config": {
    "platform": {
      "php": "7.2.34"
    }
  }
}

config.platform.php 只模拟 Composer 解析依赖时看到的 PHP 版本,不会安装 PHP、切换解释器,也不能保证应用代码兼容旧版本。

重新解析依赖

保存配置后执行:

1
composer update

Composer 会按目标 PHP 版本重新解析并更新 composer.lock,无需先删除锁文件。

参考:Composer platform 配置。

延伸阅读

Licensed under CC BY-NC-SA 4.0
最后更新于 2026-10-10
使用 Hugo 构建
主题 Stack 由 Jimmy 设计