Composer 本身无内置 bump 命令,但可通过 vinkla/composer-bump 插件实现语义化版本自动升级、提交与打标签;支持 patch/minor/major 提升、指定版本、预发布及跳过 Git 操作。

Composer 本身没有内置的 bump 命令,但可以通过第三方插件(最常用的是 vinkla/composer-bump)实现自动更新 composer.json 中的版本号,并打 Git 标签。它适合语义化版本(SemVer)管理,尤其在发布新版本时省去手动修改和提交的步骤。
安装 composer-bump 插件
在项目根目录下运行:
-
composer require --dev vinkla/composer-bump(推荐本地安装,仅开发环境使用) - 安装后,
composer bump命令即可直接使用
基本用法:提升版本号
命令会自动读取当前 version 字段,按规则升级并更新 composer.json,同时创建 Git 提交和 tag:
-
composer bump patch→ 例如1.2.3→1.2.4 -
composer bump minor→1.2.3→1.3.0 -
composer bump major→1.2.3→2.0.0 -
composer bump 2.1.0→ 指定具体版本(需符合 SemVer 格式)
默认会执行:git add composer.json、git commit -m "Bump version to x.y.z"、git tag vx.y.z。如不希望自动提交,可加 --no-commit 或 --no-tag 参数。
注意事项与常见配置
确保项目已初始化 Git 仓库,且当前分支干净(无未提交更改),否则命令会中止。
- 版本字段必须存在于
composer.json的顶层("version": "1.2.3"),不能只靠 VCS 推断 - 支持预发布版本,如
composer bump --pre=beta minor→1.3.0-beta.1 - 如需跳过 Git 操作(比如仅更新 JSON),可用
--no-commit --no-tag - 插件会检查是否已存在同名 tag,避免重复;若要强制覆盖,需先手动删除旧 tag
基本上就这些。只要版本字段规范、Git 状态正常,一条命令就能完成语义化版本升级和标记,适合集成进发布流程。










