根本原因是Packagist官方未索引该包,国内镜像仅同步其数据;需确保包托管于公开Git仓库、composer.json中name字段合规(英文+短横线)、已绑定账号并开启webhook,三者缺一不可。

为什么你的中文包在 Packagist 镜像上搜不到
根本原因不是镜像“不支持中文”,而是 Packagist 官方站点(packagist.org)本身不索引私有仓库或未提交的包;国内镜像(如 https://packagist.phpcomposer.com 或 https://mirrors.aliyun.com/composer)只是定时同步官方索引,不会主动收录你本地写的包。想让包出现在镜像里,必须先让包被 packagist.org 收录。
发布前必须满足的 3 个硬性条件
缺一不可,否则提交会失败或无法自动同步到镜像:
- 包代码托管在公开可访问的 Git 仓库(GitHub / Gitee / GitLab),且仓库名格式为
vendor/name(例如myorg/chinese-utils),不能是下划线或大写字母 -
composer.json中必须包含合法的name(与仓库路径一致)、type、autoload和至少一个语义化版本 tag(如v1.0.0) - 你已在
packagist.org登录并绑定对应 Git 平台账号(GitHub/Gitee 等),且开启 webhook 自动推送
提交后镜像多久能同步
阿里云、腾讯云等主流 Composer 镜像通常每 15–30 分钟拉取一次 packagist.org 的完整索引,不是实时同步。如果你刚在 packagist.org 提交成功,但 composer search chinese-utils 还搜不到,大概率是镜像还没刷新,不是配置或网络问题。
验证方式:直接访问 https://packagist.org/packages/myorg/chinese-utils,能打开说明已上线;再过半小时查镜像即可。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论(Discussion)”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性,以及撰写结论。当用户输入以下任一指令时也会自动触发该功能: - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
注意:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 只影响安装源,不影响包是否被索引——索引只由 packagist.org 决定。
中文包名和描述的常见坑
包名(name 字段)必须是英文+短横线,不能含中文、空格、下划线;中文只能出现在 description 或 keywords 里。否则 packagist.org 会拒绝提交。
示例错误写法:"name": "张三/中文工具" → 会被拒
正确写法:"name": "zhangsan/chinese-utils","description": "一个用于处理中文字符串的 PHP 工具包"
另外,Gitee 用户需注意:Packagist 官方目前对 Gitee 的 webhook 支持不稳定,建议手动触发同步(在 packagist.org 包页点 “Update”),或优先用 GitHub。
国内镜像不会“收录”你的包,它只镜像 packagist.org 的数据。真正卡点永远在 packagist.org 的准入和 Git 仓库的合规性,而不是镜像配置。

















