Composer中文环境下针对Composer-Repository-Type的自定义协议开发-composer-PHP中文网

composer不支持中文type，仅接受vcs、composer、package、artifact、path五种小写英文类型；填中文或其他非法值会静默跳过，导致仓库失效；正确扩展需用vcs+插件注册协议前缀，或选用artifact/composer类型实现内网分发。

composer中文环境下针对composer-repository-type的自定义协议开发

Composer 不支持“中文 type”，所谓“中文自定义 Repository 驱动”是配置误用的典型结果——你填的 "type": "私有源" 或 "type": "内网仓库" 会被完全忽略，不报错、不警告，只静默跳过。

为什么写中文 type 会静默失效

Composer 在解析 repositories 时，对 type 字段做硬编码校验，仅接受以下五种字符串：vcs、composer、package、artifact、path。任何其他值（包括中文、拼音、带空格或连字符的英文）都会被直接丢弃：

填 "type": "git-internal" → 跳过该仓库，composer install 仍走 packagist.org（除非已禁用）
填 "type": "私有源" → 同样跳过，Could not find package xxx 错误实际源于此
即使你写了合法 URL 且能手动 curl 通，Composer 根本不会尝试访问它

想支持新协议（如 gitlab-ssh://），必须用 vcs + 插件注册

真正可行的扩展方式，不是改 type，而是让 Composer 在 "type": "vcs" 下识别你自定义的 URL 协议前缀：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

你的仓库配置仍必须是：{"type": "vcs", "url": "gitlab-ssh://gitlab.example.com/group/pkg.git"}
插件中调用 RepositoryManager::addRepositoryClass('gitlab-ssh', MyGitlabSshDriver::class)，第一个参数是协议前缀（小写、无冒号）
MyGitlabSshDriver 必须完整实现 VcsDriverInterface，包括 getBranches()、getTags()、getDist() 等方法
类必须可自动加载，插件需通过 composer require 安装到项目中，否则 activate() 不会执行

artifact 和 composer 类型才是内网分发的主力方案

如果你的目标是断外网环境下的包分发，vcs 类型依赖网络可达性，反而不如以下两种稳定：

artifact：把所有 .zip 放本地目录（如 ./packages/），文件名必须为 vendor-name-version.zip（全小写、中划线、无 v 前缀），且压缩包内 composer.json 的 name 和 version 必须与文件名严格一致
composer：部署 Satis 或 Artifactory，URL 指向返回标准 packages.json 的 HTTP 接口，并在 repositories 中显式设 "packagist.org": false
两者都要求禁用默认源：composer config --global repo.packagist false，否则优先走官方源