如何使atk4/audit库兼容稳定版与dev-develop分支？

我来帮你梳理下这个问题的核心解法——本质上是要让Composer能正确识别你的扩展在稳定版和开发分支下的依赖逻辑，同时兼容atk4/data的对应版本。以下是一步步的实操方案：

1. 调整composer.json的依赖约束（核心步骤） #

首先要确保你的扩展对atk4/data的版本约束同时覆盖稳定版和对方的开发分支。在atk4/audit的composer.json里修改require字段：

{
  "name": "atk4/audit",
  "require": {
    "atk4/data": "^1.3 || dev-develop"
  },
  "minimum-stability": "dev",
  "prefer-stable": true
}

• ^1.3：保证稳定版atk4/audit[1.0]能匹配兼容的atk4/data稳定版；
• dev-develop：允许依赖atk4/data的develop开发分支；
• minimum-stability: dev：让Composer允许安装开发版本的依赖，但prefer-stable: true会让它优先选择稳定版（兼顾生产和开发场景）。

2. 给开发分支配置版本别名（可选但推荐） #

如果你的dev-develop分支是为了开发atk4/audit的下一代版本（比如2.0），建议添加分支别名，让Composer能更好地识别版本关系：

{
  "extra": {
    "branch-alias": {
      "dev-develop": "2.0.x-dev"
    }
  }
}

这样当用户安装atk4/audit:2.0.x-dev时，会自动指向你的develop分支，同时也能和atk4/data的对应版本别名更好地兼容。

3. 分支专属的composer.json配置（进阶） #

如果dev-develop分支需要依赖atk4/data的开发分支（而非稳定版），可以在develop分支单独维护一份适配的composer.json：

• 稳定版（1.0分支）保持require: {"atk4/data": "^1.3"}；
• develop分支改为require: {"atk4/data": "dev-develop"}或者^2.0@dev（如果对方开发分支对应2.0版本）。
  Composer在安装不同分支时会自动读取对应分支的配置，避免版本冲突。

4. 排查与验证 #

• 测试稳定版安装：在空项目里执行composer require atk4/audit:1.0，确认能正常拉取atk4/data[1.3]；
• 测试开发分支安装：执行composer require atk4/audit:dev-develop，如果需要同时拉取atk4/data的开发分支，可明确指定：composer require atk4/audit:dev-develop atk4/data:dev-develop；
• 排查冲突原因：如果仍报错，用composer why-not atk4/data:dev-develop命令查看具体的依赖冲突点，比如是否有其他依赖限制了atk4/data的版本。

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