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。
