Composer 不提供发布功能，发布类库需推送到 Git 仓库并在 Packagist 注册；必须遵循 PSR-4 规范、正确配置 autoload、打符合 SemVer 的 tag、确保 Packagist webhook 活跃且 composer.json 中 name 全局唯一。

Composer 本身不提供“发布”功能，它只是 PHP 的依赖管理工具；真正发布类库靠的是将代码推送到 Git 仓库（如 GitHub），再在 Packagist 上注册包名并同步元数据。搞不清这点，你会卡在“本地能装，别人 composer require 不到”的阶段。

确保类库结构符合 PSR-4 自动加载规范

Composer 加载你的类，完全依赖 autoload 配置和目录结构匹配。不按规范来，Class not found 是必然结果。

• 根目录下必须有 composer.json，其中 autoload 段明确声明命名空间与路径映射，例如：

  "autoload": {
    "psr-4": {
      "MyVendor\MyPackage\": "src/"
    }
  }

• src/ 目录下必须存在对应命名空间的子目录结构，比如 src/Http/Client.php 对应类 MyVendorMyPackageHttpClient
• 运行 composer dump-autoload -o 生成优化后的自动加载文件，开发时可省略 -o，但 CI/CD 或发布前建议加上

打标签（tag）是 Packagist 识别版本的关键

Packagist 不读 master 或 main 分支，只认 Git tag。没有 tag，别人 composer require myvendor/mypackage 默认拉不到任何稳定版。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

• 版本号必须符合 SemVer 格式，如 v1.0.0、v2.3.1，前面加 v 是惯例（Packagist 支持，也兼容不带 v 的，但统一用 v 更稳妥）
• 打 tag 前确保 composer.json 中的 version 字段与 tag 一致（非必需，但写上能减少歧义）
• 命令示例：

  git tag v1.0.0
  git push origin v1.0.0

• Packagist 默认每 15 分钟轮询一次更新；也可手动点击 “Update” 触发同步（需已绑定仓库）

在 Packagist 上提交包并保持 webhook 活跃

第一次提交后，Packagist 会监听你仓库的 push 和 tag 事件。但若长时间无活动，webhook 可能被 GitHub/GitLab 自动禁用，导致新 tag 不同步。

• 前往 https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19 登录，点击右上角 “Submit” → 粘贴你的 Git 仓库 HTTPS 地址（如 https://github.com/myvendor/mypackage）
• 成功后进入包页面，点 “Manage” → “GitHub / GitLab / Bitbucket Integration”，按指引安装 Packagist App 并授权仓库权限
• 检查 GitHub Settings → Webhooks，确认 https://www.php.cn/link/ec811d0d775adc62776ba80fadd4ed19/github-webhook 状态为 active，且最近一次 delivery 是 2xx
• 如果旧 tag 没同步，可手动点 “Force update”；但新 tag 推送后仍失败，大概率是 webhook 断了

最常被忽略的一点：类库的 composer.json 必须有明确的 name（格式为 vendor/package），且该 name 在 Packagist 上全局唯一——重名会导致提交失败，而错误提示非常模糊，只会说 “package not available”。