minimum-stability用于设置Composer可安装的最低稳定性,默认为stable,仅安装稳定版。可通过修改该值为dev、alpha、beta、RC或stable来放宽限制,但建议生产环境保持stable,并通过具体版本约束按需引入非稳定包,以确保依赖安全可控。

在 composer.json 中,minimum-stability 用于控制 Composer 安装依赖包时可接受的最低稳定性。它不会影响你明确指定版本的包,只对未锁定稳定性的依赖起作用。
可用的稳定性选项(从低到高)
• dev — 开发分支,如dev-main、dev-develop• alpha — 阿尔法版本
• beta — 贝塔版本
• RC — 候选发布版本(Release Candidate)
• stable — 稳定版本(默认)
默认值是 stable,意味着只会安装稳定版依赖。
如何设置 minimum-stability
直接在 composer.json 根层级添加或修改字段:
{
"minimum-stability": "beta"
}
这样 Composer 就允许安装 beta 及以上稳定性的包(包括 stable、RC、beta)。
更灵活的方式:使用 preferred-install
如果你只想对某些包放宽限制,推荐使用 prefer-stable 搭配 require 中的特定版本约束,而不是全局降低 minimum-stability。
例如:
{
"minimum-stability": "dev",
"prefer-stable": true,
"require": {
"some/package": "dev-feature-branch as 1.0.x-dev"
}
}
这个配置表示:允许最低到 dev 的包,但优先选择稳定版本,仅对特定包使用开发分支。
实际建议
• 生产项目建议保持"minimum-stability": "stable"• 如需测试非稳定版本,用具体版本约束更安全,比如:
"symfony/http-foundation": "6.4.x-dev"• 不要随意设为
dev,可能导致意外安装不稳定依赖
基本上就这些,合理使用 minimum-stability 和版本约束,能更好控制项目依赖质量。










