Composer默认只安装stable版本,即使版本号满足约束也会跳过dev、alpha、beta等不稳定版本;通过"minimum-stability"可全局放宽限制,如设为"beta"则允许beta及以上版本;启用"prefer-stable": true可优先选择稳定版;还可通过版本约束语法为特定包单独指定不稳定版本,如"5.4.x-dev"或"9.5.0@beta",以覆盖全局规则。

Composer 的依赖解析会根据你项目中定义的版本约束和包的稳定性标签(如 dev、alpha、beta、RC、stable)来决定哪些版本可以被安装。稳定性直接影响默认行为,即使版本号满足约束,也可能因稳定性不足而被跳过。
默认稳定性规则:只允许 stable
如果你没有显式配置最低稳定性,Composer 默认只允许安装 stable 版本。这意味着:
- 即使你的
composer.json写了"monolog/monolog": "^2.0",而当前最新是2.1.0-beta1,Composer 不会安装它。 - Composer 会跳过所有低于 stable 的版本,只考虑正式发布版(如
2.0.0、2.1.0)。
通过 "minimum-stability" 调整全局容忍度
你可以用 minimum-stability 字段放宽限制:
- dev:允许所有开发版(包括 dev、alpha、beta、RC、stable)
- alpha:允许 alpha 及更稳定版本
- beta:允许 beta 及更稳定版本
- RC:允许候选版及 stable
- stable:仅允许正式版(默认)
例如设置:
"minimum-stability": "beta"
这会让 Composer 在解析依赖时接受 beta、RC 和 stable 版本,但跳过 alpha 和 dev(除非特别指定)。
用 "prefer-stable" 控制优先级
即使允许较低稳定性版本,你仍可让 Composer 优先选择稳定版:
"prefer-stable": true
当启用后,如果存在满足条件的 stable 版本,Composer 会优先使用它,而不是更高版本号的 beta 或 RC。
针对特定包覆盖稳定性要求
使用 conflict、provide 或更常见的是 version constraint syntax 来为个别包指定可接受的不稳定版本:
-
"symfony/http-client": "5.4.x-dev"—— 明确允许 dev 分支 -
"phpunit/phpunit": "9.5.0@beta"—— 指定允许 beta 版 -
"doctrine/orm": "2.10.0-RC1"—— 允许 RC 版
这种写法会临时“提升”该包的允许级别,不受全局 minimum-stability 完全限制(但仍需符合规则)。比如全局是 stable,你就不能直接写 dev-main,除非用 @dev 后缀或调整配置。
基本上就这些。Composer 的稳定性机制是为了防止意外引入不稳定的代码,理解它能帮你更好控制依赖升级路径。










