如何根据PHP版本在composer.json中配置不同依赖版本？

要实现系统运行PHP7.x时安装mylib的^1.0版本，PHP8.x时安装^2.0版本的需求，可通过以下两种方式配置composer.json：

方式一：依赖库已声明PHP兼容性约束 #

如果mylib的composer.json中已经正确定义了版本与PHP的兼容关系（比如^1.0版本要求php: ^7.0，^2.0版本要求php: ^8.0），只需在项目的composer.json中添加如下配置：

{
    "require": {
        "php": "^7.0 || ^8.0",
        "mylib": "^1.0 || ^2.0"
    }
}

Composer会自动根据当前环境的PHP版本，筛选出兼容的mylib版本进行安装：

• 当PHP版本为7.x时，会排除需要PHP8的^2.0版本，自动安装^1.0
• 当PHP版本为8.x时，会优先安装更高版本的^2.0

方式二：手动添加版本冲突约束 #

如果mylib未声明PHP兼容性约束，可通过conflict块手动添加条件限制：

{
    "require": {
        "php": "^7.0 || ^8.0",
        "mylib": "^1.0 || ^2.0"
    },
    "conflict": {
        "mylib": "^2.0" when "php < 8.0",
        "mylib": "^1.0" when "php >= 8.0"
    }
}

该配置的作用：

• require块声明项目支持PHP7.x和8.x，同时允许mylib的1.x、2.x版本
• conflict块添加条件冲突规则：
  • 当PHP版本低于8.0时，禁止安装mylib的^2.0版本
  • 当PHP版本不低于8.0时，禁止安装mylib的^1.0版本

这种配置既能照顾无法快速升级到PHP8的客户，也能让已升级PHP8的用户使用最新的mylib版本，推进版本迭代。

内容的提问来源于stack exchange，提问作者Max