如何在Composer中配置自动化的版本号更新

如何在Composer中配置自动化的版本号更新

Composer本身不支持自动更新版本号

先说一个核心事实：Composer里的那个version字段，本质上就是个静态的元数据。它既不会自己递增，也不参与依赖解析，更不会被composer update这类命令修改。你手动改也好，用脚本改也罢，Composer都只把它当作一个普通的字符串来处理。所以，如果谁指望通过composer.json的配置来实现“代码一提交，版本号就自动往上蹦”，那恐怕是误解了Composer的设计初衷。

用Git标签 + composer dump-autoload --classmap-authoritative配合语义化版本

那么，在实际项目中，靠谱的版本管理究竟该怎么做？关键在于，别让Composer去“生成”版本，而要让它“认可”一个可信的版本。这套方法的核心，是把composer.json里的version字段和Git的发布标签严格对齐，再通过CI/CD流程来做强制校验。

• 在开发阶段，你可以在composer.json里写上"version": "dev-main"，或者干脆留空——composer install会根据你当前的Git标签自动推断。
• 到了发布的时候，务必打上带前缀的Git标签，比如v1.2.3，并且要确保这个标签名和composer.json里写的version完全一致。
• 在CI流程中，加入一个验证步骤：运行git describe --tags --exact-match HEAD 2>/dev/null。这个命令会检查当前提交是否有一个精确对应的标签，如果检查失败，就应该立刻中断发布流程。
• 当你执行composer install --no-dev --optimize-autoloader时，Composer会把当前的标签名注入到vendor/composer/installed.json这个文件里。之后，你就可以通过Composer\InstalledVersions::getVersion('your/package')来读取这个确切的版本号了。

常见错误：用composer bump或第三方插件强行自增

市面上有一些看似“省事”的做法，比如使用composer bump命令或者第三方插件来自动递增版本号。但必须警惕的是，这类做法往往破坏了语义化版本的基本契约，会埋下不少隐患：

• 像composer-bump-plugin这样的工具，确实会直接修改composer.json里的version字段，但如果它没有同步打上Git标签，就会产生一个没有对应代码快照的“幽灵版本”。后续别人执行composer require时，就可能拉到这个不存在的版本。
• 另一种常见情况是，在CI中执行了composer bump patch，但却忘了紧接着执行git commit -m "bump"和git push --tags。结果就是，Packagist（Composer的官方包仓库）根本收不到新版本的信息，导致其他开发者永远无法通过composer update拉取到这次更新。
• 还有的开发者会把version设置成"1.0.*"或"dev-main"这样的动态值，却没有在repositories中正确配置vcs类型。这会导致Packagist直接拒绝收录你的包，在本地执行composer require时会报错：Could not find package your/name at any version。

真正自动化的核心在Git和CI，不在Composer

一句话总结：Composer只负责消费版本，它压根不负责生成版本。如果你想要实现“每次代码合并到main分支就自动发布一个新版本（比如v1.2.4）”这样的自动化流程，正确的发力点不在Composer，而在你的Git工作流和CI/CD管道。

• 在GitHub Actions或GitLab CI这样的CI工具里，集成conventional-commits来解析提交信息，然后调用standard-version这类工具来自动生成更新日志（Changelog）并打上对应的Git标签。
• 记得在CI环境中配置好Git身份，比如使用git config --global user.name 'CI Bot'并设置好具有相应权限的token，确保自动打的标签能够成功推送到远程仓库。
• 在Packagist上，务必勾选“Update automatically”选项，并确保Webhook的触发地址配置正确。这里有个常被忽略的细节：对于私有的GitLab仓库，你需要手动去配置Webhook，因为Packagist不会主动去轮询私有仓库的更新。
• 最后，检查一下composer.json里的type字段。如果它被设置成了project，Packagist会直接忽略这个包，不会把它当作一个可以被其他项目require的库。正确的类型应该是library或metapackage。

说到底，版本号能不能“自动”起来，完全取决于你的Git工作流是否形成了一个严密的闭环。Composer连一个最简单的递增函数都没提供，所以，别指望它来替你做出发布决策。