Composer的 "update --prefer-stable" 和 "minimum-stability" 有什么关系_Composer依赖解析稳定性策略详解

minimum-stability 设置可安装的最低稳定性级别，影响所有依赖；--prefer-stable 则在符合条件的版本中优先选择更稳定的版本，两者协同控制依赖解析行为。

在使用 Composer 管理 PHP 项目依赖时，minimum-stability 和 --prefer-stable 是两个影响依赖版本选择的重要机制。它们共同作用于依赖解析过程，但职责不同，理解其关系有助于更精确地控制包的安装行为。

minimum-stability：全局稳定性门槛

minimum-stability 定义了项目允许安装的最低稳定性级别。它是一个配置项，通常写在 composer.json 中，可选值包括：dev、alpha、beta、RC、stable（默认为 stable）。

它的作用是过滤所有候选版本：只有稳定性 >= 设定值的版本才会被考虑。例如：

• 设置为 beta，则 beta、RC、stable 版本都可安装，但不会选择 alpha 或 dev 分支
• 设置为 stable，仅 stable 版本被允许

这个设置对项目及其所有依赖的传递性依赖都生效，除非被更细粒度的规则覆盖。

--prefer-stable：优先选择稳定版本的策略

即使 minimum-stability 允许安装不稳定版本，加上 --prefer-stable 参数后，Composer 会优先选择稳定版本，即使存在更高版本号但不稳定的候选。

关键点在于：--prefer-stable 不改变 minimum-stability 的过滤规则，而是影响在通过过滤的版本中如何排序和选择。

举个例子：

• 某包有版本：1.0.0-beta1（beta）、1.0.0（stable）
• minimum-stability 设置为 beta
• 不加 --prefer-stable：可能安装 1.0.0-beta1（如果满足约束）
• 加上 --prefer-stable：Composer 会优先选 1.0.0，即使 beta 版本也符合条件

这在团队协作或生产环境中很有用——允许临时使用 beta 包，但始终倾向用上正式版。

标签： php js json composer