Composer怎么创建自己的包_发布Composer包到Packagist教程【高阶】

必须先创建公开gitHub仓库并配置合规composer.json，再打合法Git tag（如v1.0.0）推送，最后提交仓库URL至Packagist索引；name需为vendor/name格式、autoload和license必填且正确，否则索引失败。

不能直接“创建包”再“发布到 Packagist”——Packagist 不托管代码，只索引 Git 仓库；你必须先有公开的 Git 仓库（如 github），且该仓库包含合法的 composer.json，Packagist 才能抓取并收录。

怎么写一个可被 Composer 安装的 composer.json

这是整个流程的起点，也是最容易出错的一环。不是随便放个 JSON 就行，Packagist 会校验基础字段是否合规：

• name 必须是 vendor/name 格式（如 myname/my-awesome-package），且全小写、只含字母/数字/-/_；vendor 名需与你在 Packagist 的用户名一致
• type 推荐设为 library（除非是插件、wp-plugin 等特殊类型）
• autoload 必须配置，否则别人 require 后无法自动加载你的类；最常用的是 "psr-4": {"MyName\MyAwesomePackage\": "src/"}
• license 必须明确（如 "MIT"），空值或模糊值（如 "proprietary"）会导致 Packagist 拒绝索引
• 不要写 repositories 字段——那是使用者的配置，不是包自身的声明

为什么 GitHub 仓库要公开 + 有 Git tag 才能被 Packagist 正确识别

Packagist 不拉取 main 分支最新代码，它靠 Git tag 版本号（如 v1.0.0、1.0.0）来生成可用版本。没有 tag，Packagist 就只显示 “No releases found”，用户也 install 不到任何稳定版：

• 本地打 tag：运行 git tag -a v1.0.0 -m "First stable release"
• 推送到 GitHub：运行 git push origin v1.0.0（注意不是 git push --tags，后者可能推送太多旧 tag）
• Packagist 默认每 15 分钟轮询一次；也可手动在 Packagist 页面点击 “Update” 强制抓取
• tag 名必须符合 Composer 版本约束规则（如不支持 1.0，要写成 1.0.0 或 v1.0.0）

提交到 Packagist 的实际操作与常见失败原因

登录 Packagist（用 GitHub 账号授权），点击右上角 “Submit” → 粘贴你的 GitHub 仓库 URL（如 https://github.com/myname/my-awesome-package）。接下来不是“上传”，而是“请求索引”：

• 如果提示 “this package is not on GitHub, Bitbucket or gitlab”，检查 URL 是否拼错，或仓库是否设为私有
• 如果提示 “Could not fetch … composer.json”，说明仓库根目录没有 composer.json，或文件语法错误（可用 composer validate 本地检查）
• 如果提交成功但版本为空，大概率是没打合法 tag，或 tag 未推送到远程
• Packagist 不允许重复提交同一仓库；删了再重提前，先去仓库 Settings → Webhooks 删掉旧的 Packagist hook

发布后还要注意什么

很多人以为提交完就结束了，其实后续维护才是关键：

• 每次发新版，必须打新 tag 并推送，否则 Packagist 不会自动更新版本列表
• 修改 composer.json 后（比如加依赖），必须重新打 tag —— Packagist 抓取的是 tag 对应快照，不是动态读取主分支
• 若想让别人 composer require myname/my-awesome-package 成功，你的 autoload 路径和命名空间必须与实际 php 文件结构严格匹配，否则报 class not found
• Packagist 不提供私有包支持；要做内网或私有包，得用 Satis、private Packagist 或 GitHub Packages 配合自建 repositories