Composer通过语义化版本控制与Git标签协同管理PHP包发布。主版本号变更表示不兼容更新,次版本号为兼容性新功能,修订号用于bug修复。必须使用v前缀的规范标签(如v1.0.0),推送至远程后Packagist自动同步,用户即可通过composer update获取。开发分支用dev-main引用,稳定版依赖打标签版本,预发布需设置稳定性标志。遵循“改功能→提交→打标签→推送”流程,确保依赖解析准确和更新平滑。

Composer 通过语义化版本控制(Semantic Versioning)与 Git 标签协同工作,实现 PHP 包的规范化发布管理。只要遵循标准流程,就能确保依赖解析准确、更新平滑。
语义化版本规范(SemVer)
Composer 完全支持 semver(如 1.0.0、2.1.3、1.5.0-beta.1),版本号格式为 主版本号.次版本号.修订号:
- 主版本号(MAJOR):重大变更,不兼容旧版本时递增
- 次版本号(MINOR):新增功能但向后兼容,递增次版本
- 修订号(PATCH):修复 bug 或微小调整,保持兼容性
例如:从 1.2.3 升级到 1.3.0 是兼容的功能增强,而升级到 2.0.0 可能包含破坏性变更。
Git 标签与 Composer 的自动识别
Composer 通过 Git 标签来识别包的正式版本。你必须在 Git 仓库中打标签,且标签名需符合版本格式:
- 推荐使用带
v前缀的标签(如 v1.0.0),Composer 能自动去除前缀解析为 1.0.0 - 避免使用非标准标签(如
release-1、beta),否则无法被 Packagist 正确识别 - 每次发布新版本都应在对应提交上打标签并推送到远程仓库
示例操作:
git tag v1.1.0 -m "Release version 1.1.0" git push origin v1.1.0
Packagist 自动同步与版本发现
如果你的包已提交至 Packagist,它会监听仓库的 Git 标签。当新标签被推送后:
- Packagist 通常在几分钟内自动抓取新版本
- 用户执行
composer update时即可拉取最新发布的版本 - 建议在项目
composer.json中设置 autoload 和 require 明确规则,避免加载异常
开发分支与稳定版本的区分
Composer 能根据版本约束自动选择合适版本:
- 使用
dev-main或dev-develop引用开发分支(需启用 minimum-stability 配置) - 正式版本优先使用带标签的稳定版(如 ^1.2)
- 通过
stability flags控制预发布版本(alpha、beta、RC)的可见性
例如:"my/package": "^1.3" 会匹配 1.3.0 到 2.0.0 之前的版本,跳过未打标签的提交。
基本上就这些。只要坚持“改功能 → 提交代码 → 打标签 → 推送”,Composer 就能正确管理你的包版本。关键是标签要规范,版本要符合 semver。
以上就是Composer如何规范化处理包的版本发布与Git标签(tagging)的详细内容,更多请关注php js git json composer ai php composer json require git bug


