如何使用 Composer 的 bump 命令(通过插件)来提升项目版本?

裘德小鎮的故事
发布: 2025-12-17 18:55:02
原创
251人浏览过
Composer 本身无内置 bump 命令,但可通过 vinkla/composer-bump 插件实现语义化版本自动升级、提交与打标签;支持 patch/minor/major 提升、指定版本、预发布及跳过 Git 操作。

如何使用 composer 的 bump 命令(通过插件)来提升项目版本?

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.31.2.4
  • composer bump minor1.2.31.3.0
  • composer bump major1.2.32.0.0
  • composer bump 2.1.0 → 指定具体版本(需符合 SemVer 格式)

默认会执行:git add composer.jsongit commit -m "Bump version to x.y.z"git tag vx.y.z。如不希望自动提交,可加 --no-commit--no-tag 参数。

ListenLeap
ListenLeap

AI辅助通过播客学英语

ListenLeap 217
查看详情 ListenLeap

注意事项与常见配置

确保项目已初始化 Git 仓库,且当前分支干净(无未提交更改),否则命令会中止。

  • 版本字段必须存在于 composer.json 的顶层("version": "1.2.3"),不能只靠 VCS 推断
  • 支持预发布版本,如 composer bump --pre=beta minor1.3.0-beta.1
  • 如需跳过 Git 操作(比如仅更新 JSON),可用 --no-commit --no-tag
  • 插件会检查是否已存在同名 tag,避免重复;若要强制覆盖,需先手动删除旧 tag

基本上就这些。只要版本字段规范、Git 状态正常,一条命令就能完成语义化版本升级和标记,适合集成进发布流程。

以上就是如何使用 Composer 的 bump 命令(通过插件)来提升项目版本?的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号