minimum-stability是Composer中控制依赖包最低稳定性的配置项，位于composer.json文件中，默认值为stable，可选dev、alpha、beta、RC、stable。它决定未明确指定版本约束的包可安装的稳定性范围，例如设为beta时可安装beta、RC和stable版本。若全局设为dev可能导致所有依赖拉取不稳定版本，因此建议保持minimum-stability为stable，并通过@dev或dev-branch等方式单独引入特定开发包。结合prefer-stable可优先选择稳定版本，仅对指定包放宽限制，常用于生产环境需稳定但个别依赖需测试新功能的场景。合理配置可在灵活性与稳定性间取得平衡。
在使用 Composer 管理 PHP 项目依赖时，minimum-stability 是一个关键配置项，它决定了项目允许安装的依赖包的最低稳定性。这个字段直接影响你引入第三方库时的版本选择范围。
minimum-stability 是什么？
该字段用于指定当前项目中所有未明确指定稳定性的依赖包，默认可接受的最低稳定级别。Composer 中的包版本通常有以下几种稳定性等级（从低到高）：
- dev：开发分支（如 git 的主干）
- alpha：内测版本
- beta：公测版本
- RC（Release Candidate）：发布候选版
- stable（默认）：稳定版
当你没有为某个依赖显式指定版本约束时，Composer 会根据 minimum-stability 的设置来筛选可用的版本。
如何设置 minimum-stability？
你可以在 composer.json 文件的顶级配置中添加或修改该字段：
{
"require": {
"monolog/monolog": "^2.0"
},
"minimum-stability": "stable"
}
可选值包括：dev、alpha、beta、RC、stable。默认值为 stable。
例如：
-
"minimum-stability": "beta"表示允许安装 beta 及以上稳定性的包（即 beta、RC、stable） -
"minimum-stability": "dev"则允许安装任何开发中的分支或预发布版本
为什么不能只靠 minimum-stability 控制个别依赖？
如果你将 minimum-stability 设为 dev，整个项目的依赖都可能拉取不稳定版本，带来风险。因此，更推荐的做法是保持全局为 stable，然后通过 alias 或 @dev 标签单独控制特定包的稳定性。
比如：
{
"require": {
"some/package": "dev-main as 1.0.x-dev"
},
"minimum-stability": "stable"
}
或者直接写：
"require": {
"laravel/framework": "9.0.x-dev"
}
这样即使全局 stability 是 stable，也能获取某个包的开发版本。
常见使用场景与建议
实际开发中，多数生产项目应保持：
"minimum-stability": "stable"
只有在需要测试新功能或依赖尚未发布稳定的包时，才临时调整。但更好的方式是结合 prefer-stable 和精确版本约束：
{
"minimum-stability": "dev",
"prefer-stable": true,
"require": {
"vendor/package": "^1.2@beta"
}
}
这样 Composer 会在可能的情况下优先选择稳定版本，仅对指定包放宽限制。
基本上就这些。合理设置 minimum-stability 能在灵活性与项目稳定性之间取得平衡。不复杂但容易忽略细节。
