Composer如何发布包到Packagist_Composer发布包到Packagist教程【必备】

发布包到 Packagist只需提交公开Git仓库URL，确保composer.json合规（name符合vendor/package、无version、有autoload、声明PHP依赖）、Git有合规语义化Tag（如v1.0.0）并推送至远程。

很多开发者第一次发布包时，可能会下意识地去找“上传”按钮。其实，这里有个关键认知需要转变：Packagist本身并不存储你的代码。它更像一个智能的目录索引服务，专门抓取并解析那些公开的Git仓库。所以，你的核心任务不是上传文件，而是确保你的Git仓库“达标”，然后把仓库地址提交给Packagist——剩下的，它会自动处理。

你的 composer.json 必须通过 Packagist 的基本校验

这份文件是你的包的“身份证”和“说明书”，Packagist在首次抓取时会进行严格审查。以下几个要素缺一不可，任何一个出错都可能导致提交失败：

• name 字段：必须存在，并且严格遵循 vendor/package 的格式（例如 myorg/my-utils）。注意，通常建议使用小写字母和连字符，大写字母或下划线可能会带来不必要的麻烦。
• version 字段：这里有个常见的误区——千万不要在composer.json里手动写死版本号。包的版本由Git tag唯一决定，写死它反而会导致同步混乱或失败。
• autoload 配置：这是包的“灵魂”。你至少需要定义一种自动加载方式（比如最常见的 "psr-4": {"MyOrg\\": "src/"}），否则用户安装后，代码根本无法被自动加载和使用。
• PHP依赖声明：如果你的包用到了某些特定的PHP版本或扩展，务必在 require 中声明最低版本（例如 "php": "^8.1"）。忽略这一步，你的包可能会被标记为“不兼容”，影响其他开发者的使用判断。

Git 仓库必须公开 + 有语义化 Tag

Packagist与你的Git仓库打交道，有一套明确的规则。它不会去拉取main或master分支的某个随机快照，它只认一个东西：Git tag。没有tag，你的包在Packagist眼里就“不存在”。

• Tag的命名：必须符合语义化版本规范（SemVer），例如 v1.0.0 或 1.2.3。像 v1.0 或 dev 这类不规范的命名会被直接忽略。
• Tag的推送：本地打tag只是第一步，切记要推送到远程仓库：git tag v1.0.0 && git push origin v1.0.0。
• 仓库的公开性：你的仓库必须在GitHub、GitLab或Bitbucket等平台上设置为公开状态，私有仓库是无法被Packagist抓取的。
• 一个重要的提醒：如果你事后修改了某个已有tag指向的提交（比如使用了force-push），Packagist并不会自动感知这个变化。此时，你需要手动到Packagist的包管理页面点击“Update”按钮来触发更新。

在 Packagist 上提交仓库后，别等“自动同步”

提交仓库URL后，流程通常很快，几秒钟内就能完成首次抓取和上线。但以下几个“卡点”经常让开发者停滞不前：

• 如果包页面显示“This package is not auto-updated”，那基本可以断定是Webhook配置出了问题。你需要到Git仓库的设置页面（如GitHub的Settings → Webhooks），添加Packagist的Webhook地址：https://packagist.org/api/github，内容类型选择 application/json，并且通常只需勾选 Releases 事件即可。
• 假如提交后一直显示“Package not found”，别慌。建议先在本机用 composer validate 命令检查composer.json的合法性，然后再确认tag是否真的推送成功了（运行 git ls-remote --tags origin 查看远程tag列表）。
• 首次成功后，后续发布新版本（打新tag）按理应该自动同步。但这完全依赖于Webhook的成功触发。如果没配Webhook，每次更新都只能回到Packagist页面手动点击“Update”。

最后，必须强调一个最容易被忽略，也最关键的事实：Packagist不验证你的代码逻辑，也不运行任何测试。它的校验范围仅限于composer.json的结构、tag的存在性以及autoload的配置是否可用。这意味着，哪怕你的src/目录是空的，只要composer.json通过了校验，包也能成功发布并被安装。当然，用户在执行require后，很快就会遇到Class not found的错误。所以，确保代码本身正确可用，始终是你的责任。