Composer如何设置最低稳定性（minimum-stability）-composer-PHP中文网

Composer如何设置最低稳定性（minimum-stability）

穿越時空

发布： 2025-09-20 19:18:02

原创

392人浏览过

minimum-stability是Composer中控制依赖包最低稳定性的配置项，支持stable、RC、beta、alpha、dev五种级别，默认仅安装稳定版；可通过在composer.json中设置minimum-stability字段调整全局级别，如设为dev可安装开发版本；推荐做法是保持minimum-stability为stable，对特定包单独指定低稳定性版本（如6.4.x-dev），并结合prefer-stable:true优先使用稳定版本；适用于试用新功能或引入未发布修复的场景，但生产环境应谨慎使用不稳定的依赖。

composer如何设置最低稳定性（minimum-stability）

在使用 Composer 管理 PHP 项目依赖时，minimum-stability 是一个关键配置项，用于控制允许安装的依赖包的发布稳定性级别。默认情况下，Composer 只会安装稳定版本（如

stable

登录后复制

），但有时你需要使用开发中的版本（如

dev

登录后复制

、

alpha

登录后复制

等），这时就需要调整最低稳定性。

什么是 minimum-stability？

该配置定义了项目中所有依赖包的最低稳定性要求。Composer 支持以下几种稳定性级别（从高到低）：

stable：稳定版（无后缀或 -stable）
RC：候选发布版（-RC*）
beta：测试版（-beta*）
alpha：早期测试版（-alpha*）
dev：开发版（-dev）

设置

minimum-stability

登录后复制

后，Composer 将只考虑等于或高于该级别的版本。

如何设置全局 minimum-stability

你可以在项目的

composer.json

登录后复制

文件中设置整个项目的最低稳定性：

{
    "require": {
        "monolog/monolog": "^2.0"
    },
    "minimum-stability": "dev"
}

登录后复制

上面示例中，

minimum-stability

登录后复制

被设为

dev

登录后复制

，意味着允许安装开发版本的依赖包。

按包单独控制稳定性（推荐做法）

直接降低整体

minimum-stability

登录后复制

可能导致其他依赖也使用不稳定的版本，带来风险。更安全的方式是保持全局稳定性为

stable

登录后复制

，仅对特定包允许更低稳定性：

易笔AI论文

专业AI论文生成，免费生成论文大纲，在线生成选题/综述/开题报告等论文模板

103

查看详情

{
    "require": {
        "symfony/symfony": "6.4.x-dev",
        "monolog/monolog": "^2.0"
    },
    "minimum-stability": "stable",
    "prefer-stable": true
}

登录后复制

在这个例子中：

全局
```
minimum-stability
```
登录后复制
保持为
```
stable
```
登录后复制
```
symfony/symfony
```
登录后复制
明确指定了
```
6.4.x-dev
```
登录后复制
版本，Composer 会允许这个 dev 分支
```
prefer-stable
```
登录后复制
设置为
```
true
```
登录后复制
表示：如果存在稳定版本，优先选择稳定版本，即使有更新的开发版