如何为已发布到Packagist的PHP包的已发版本添加依赖上限

存在合规方案，无需修改已发布的历史标签、无需更换包名，不会影响已锁定旧版本的现有用户使用。

核心实现逻辑 #

Composer 做依赖解析时会优先匹配同分支下最高版本号的发行版，只要让 1.0.x 分支下的最高版本不兼容 PHP 8+，就能让整个分支在 PHP 8+ 环境下被判定为无可用匹配版本。

具体操作步骤 #

• 基于 1.0.x 分支最新代码创建版本号高于现有所有 1.0.x 版本的新标签，例如 v1.0.999（因 1.0.x 不再迭代新功能，该版本号不会和后续版本冲突）
• 修改该版本的 composer.json 配置：

  {
      "require": {
          "php": "^7.0"
      },
      "replace": {
          "你的包 vendor/name": "1.0.*"
      }
  }
  

• 将新标签推送至 Git 仓库，同步到 Packagist 平台即可。

方案优势 #

• 完全合规：未修改任何已发布的历史版本标签，不会触发 Packagist 的版本规则限制
• 不影响现有用户：已经通过 composer.lock 锁定旧版本的项目不会受到任何影响，依赖仍可正常解析
• 效果符合预期：PHP 8+ 环境下执行依赖安装时，Composer 会优先匹配最高版本 v1.0.999，因该版本不满足 PHP 版本要求，会直接判定 1.0.x 分支无适配版本，不会拉取无上限约束的旧版本

可选优化 #

你可以在 Packagist 后台将整个 1.0.x 分支标记为废弃，用户安装该分支版本时会收到废弃提示，进一步引导用户升级到兼容 PHP 8 的更高分支。

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