minimum-stability 是 Composer 的全局配置项，用于指定未明确版本约束时允许安装的依赖包稳定性级别。其取值按严格程度从高到低包括 stable、RC、beta、alpha 和 dev，级别越低表示可接受的不稳定版本范围越广。默认情况下建议设为 stable，以确保项目依赖均为正式发布版本，避免引入潜在风险。当需要引入特定非稳定包时，推荐通过版本约束中的 @ 后缀（如 ^2.0@beta）进行精细化控制，而非降低全局 minimum-stability。配合 "prefer-stable": true 可在满足依赖前提下优先选择更稳定的版本，提升项目可靠性。该机制帮助开发者在灵活性与稳定性之间取得平衡，尤其适用于生产环境对依赖安全性要求较高的场景。
minimum-stability 是 Composer 中用于控制项目依赖包默认加载版本稳定性的配置项。它的作用是告诉 Composer 在没有明确指定版本约束的情况下，允许安装哪些稳定程度的包版本。
稳定性等级说明
Composer 中的包版本有以下几种稳定性级别，按从高到低排列：
- stable（稳定版）：如 v1.0.0，无后缀的正式发布版本
- RC（Release Candidate）：候选版本，如 1.0.0-rc1
- beta：测试版，功能基本完成但可能存在 bug
- alpha：早期测试版，功能不完整，不稳定
- dev：开发分支，通常是 dev-main 或 dev-develop，可能随时变动
例如，当你执行 composer require vendor/package 而未指定版本时，Composer 会根据 minimum-stability 的设置来决定是否可以安装 alpha、beta、dev 等非稳定版本。
常见配置值
该配置支持以下取值：
- stable：只安装稳定版本（默认推荐）
- RC：允许 RC 及以上稳定性版本
- beta：允许 beta、RC、stable
- alpha：允许 alpha 及更高稳定性
- dev：允许开发分支和所有预发布版本
在 composer.json 中设置示例：
{
"minimum-stability": "beta"
}
这表示在无显式版本要求时，可安装 beta 及更稳定的版本。
更精细的控制：prefer-stable 和 stability flags
如果只想对某些特定包放宽限制，而不影响整体项目稳定性，推荐使用版本约束中的稳定性标识，而不是全局修改 minimum-stability。
例如：
"require": {
"vendor/package": "^2.0@beta",
"another/package": "dev-feature-x@dev"
}
这样即使 minimum-stability 为 stable，也能单独引入需要的非稳定包。
还可以配合 "prefer-stable": true 使用，让 Composer 在满足条件下优先选择稳定版本，避免意外安装 dev 分支。
总结
minimum-stability 是一个全局开关，影响所有未明确指定稳定性的依赖。生产环境建议保持为 stable，通过 @ 后缀或 version constraint 单独引入所需非稳定包，以平衡灵活性与项目可靠性。
基本上就这些，合理使用能有效避免引入不成熟代码导致的问题。
