prefer-stable 设置为 true 时,composer 会优先选择稳定版本。例如在 monolog 的依赖中,若有 2.0.0-beta1、2.0.0-rc1 和 2.0.0,将自动选用 2.0.0。该配置可全局设置于 composer.json 或通过命令行 –prefer-stable 临时启用,且后者优先级更高。它与 minimum-stability 配合使用,前者决定允许安装的版本类型,后者在允许范围内优选最稳定的版本。合理使用 prefer-stable 能在灵活依赖管理的同时提升项目稳定性。
示例说明:
假设你有如下依赖:
"require": { "monolog/monolog": "^2.0" }
如果 monolog 有以下可用版本:2.0.0-beta1、2.0.0-rc1、2.0.0,且 prefer-stable: true,Composer 将选择 2.0.0 而不是任何预发布版本。
如何设置 prefer-stable
{ "config": { "prefer-stable": true } }
也可以在命令行临时启用:
composer install --prefer-stable
注意:命令行参数的优先级高于 config 中的设置。
与 minimum-stability 的关系
prefer-stable 通常和 minimum-stability 配合使用。minimum-stability 决定哪些类型的包可以被安装(如 dev、alpha、beta、RC、stable),而 prefer-stable 是在这些允许的范围内,优先选择更稳定的版本。
例如:
{ "minimum-stability": "dev", "prefer-stable": true }
表示允许安装开发版本,但如果有稳定版本可用,就优先选稳定版。
基本上就这些。合理使用 prefer-stable 可以在保持灵活性的同时提升项目的稳定性。不复杂但容易忽略。