Packagist 不支持手动上传，必须通过公开 Git 仓库自动抓取；注册需在 packagist.org 提交仓库 URL，composer.json 必须含合法 name、type 和 autoload，且仓库公开可读；自动更新依赖 GitHub Webhook 配置，推送带 tag 的代码触发同步。
Packagist 不接受手动上传，必须通过 Git 仓库自动抓取 —— 你 push 到 GitHub/GitLab 等平台后，Packagist 才能发现并索引你的包。直接执行 composer publish 或类似命令会失败，因为 Composer 本身没有发布功能。
packagist.org 上如何正确注册并绑定你的包
注册是纯 Web 操作，不涉及命令行：
- 用 GitHub/GitLab 账号登录 packagist.org
- 点击右上角「Submit」→ 填写你的 Git 仓库 URL（如
https://github.com/yourname/your-package） - 提交后 Packagist 会立即尝试 clone 并读取根目录的
composer.json - 若失败，页面会显示具体错误（常见：缺少
name、type、autoload，或仓库不可公开访问）
composer.json 必须满足的最低要求才能被 Packagist 接受
Packagist 不校验代码质量，但强制验证几个字段是否合法且符合命名规范：
-
name必须为vendor/package格式，全部小写，只含字母、数字、下划线、中划线和斜杠；例如myorg/laravel-helper，不能是MyOrg/LaravelHelper -
type建议显式声明，如library、wordpress-plugin、laravel-package -
autoload必须存在且结构有效（哪怕只是空的 PSR-4 映射）：{ "autoload": { "psr-4": { "MyOrg\\YourPackage\\": "src/" } } } - 仓库必须公开可读（私有仓库需配置 packagist.com 订阅服务）
如何让 Packagist 自动更新（无需每次手动刷新）
靠 Git 平台的 webhook 触发，不是 Composer 命令：
- 在 GitHub 仓库 Settings → Webhooks → Add webhook
- Payload URL 填
https://www.php.cn/link/5d2e892c81e5fafc51ab0973879563a0api/github - Content type 选
application/json - 只勾选
Pushes和Repository dispatch（后者用于手动触发） - 保存后，下次
git push到默认分支（通常是main或master），Packagist 就会自动 fetch 新版本 - 注意：Packagist 默认只抓取带 Git tag 的版本（如
v1.0.0），但也会同步最新dev-main（取决于你配置的 stability）
常见失败点：为什么提交后 Packagist 显示 “Package not found” 或 “Invalid package”
最常卡在这几个地方：
- GitHub 仓库设为私有，但没用 packagist.com（免费版 Packagist 只支持公开仓库）
-
composer.json中name字段包含大写字母或非法字符，比如"name": "MyProject/Utils"→ 必须改成小写 - Git 仓库根目录没有
composer.json（它不会进子目录找） - 本地
git tag v1.0.0后忘了git push --tags，导致 Packagist 看不到新版本 - Packagist 抓取时超时（通常因
autoload配置引用了不存在的路径，或scripts里有阻塞操作）
真正要小心的是 name 的格式和 autoload 的路径有效性 —— 这两个出错，Packagist 会静默拒绝，连错误详情都藏在「Latest update」时间戳后面的小感叹号里，很容易被忽略。
