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 标签。当新标签被推送后:
标小兔AI写标书
一款专业的标书AI代写平台,提供专业AI标书代写服务,安全、稳定、速度快,可满足各类招投标需求,标小兔,写标书,快如兔。
40 查看详情
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中文网其它相关文章!
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/539116.html
微信扫一扫
支付宝扫一扫