minimum-stability是Composer中控制依赖包稳定性的配置项，取值按稳定性从低到高为dev、alpha、beta、RC、stable，默认为stable；设置较低级别可安装开发版包，但会影响所有依赖，因此推荐保持全局stable并结合prefer-stable和版本后缀（如-dev、-beta）对特定包单独放宽限制，以确保项目稳定性与灵活性平衡。
在使用 Composer 管理 PHP 项目依赖时，minimum-stability 是一个关键配置项，用于控制项目允许安装的依赖包的发布稳定性级别。如果你需要引入尚未正式发布的开发版本包（如 alpha、beta、dev 等），就需要正确配置这个选项。
什么是 minimum-stability？
minimum-stability 指定 Composer 在没有明确指定版本约束的情况下，默认选择哪种稳定性的包进行安装。它的取值从低到高依次为：
- dev：开发版本（如 dev-main、dev-develop）
- alpha：内测版本
- beta：公测版本
- RC（Release Candidate）：候选版本
- stable（默认）：稳定版本
设置越低，允许安装的非稳定版本越多。
如何配置 minimum-stability
在项目的 composer.json 文件中添加或修改 minimum-stability 字段即可：
{
"require": {
"monolog/monolog": "^2.0"
},
"minimum-stability": "beta"
}
上述配置表示：在未特别说明版本时，允许安装最低为 beta 级别的包。
更精细的控制：prefer-stable 和 stability flags
直接修改 minimum-stability 会影响所有依赖，可能引入不稳定的组件。推荐做法是保持全局为 stable，并对特定包单独指定稳定性。
你可以结合使用 prefer-stable 和版本后缀来实现更安全的控制：
{
"require": {
"symfony/http-foundation": "6.4.x-dev",
"laravel/framework": "11.0.0-beta1"
},
"minimum-stability": "dev",
"prefer-stable": true
}
- prefer-stable: true 表示：如果存在稳定版本，优先选择稳定版，即使 dev 版本可用
- 通过在版本号中显式写入
-dev、-beta等后缀，可以只为特定包放宽限制
常见使用场景建议
生产环境应尽量避免降低全局 minimum-stability。以下是一些实用建议：
- 开发测试新功能时，临时设为
beta或dev - 长期项目建议保持
"minimum-stability": "stable"，仅对个别包使用不稳定版本 - 使用
composer require vendor/package:dev-branch可临时安装 dev 包，Composer 会自动调整配置 - 执行
composer update前检查变更列表，防止意外升级到不稳定版本
基本上就这些。合理设置 minimum-stability 能让你灵活使用新特性，同时避免项目陷入不可控的依赖混乱。关键是用好版本约束和 prefer-stable 配合，而不是一味降低全局稳定性要求。
