Composer私有仓库域名配置方法-composer-PHP中文网

私有仓库配置需同时满足三要素：repositories中type必须为"composer"（非"vcs"），url须以/结尾且可直接返回packages.json，且必须同级声明"packagist.org": false显式禁用默认源，缺一即导致composer静默忽略私有地址。

composer私有仓库域名配置方法

私有仓库的域名配置不是“填对 URL 就完事”，关键在于 repositories 的类型、URL 的协议与后缀、以及是否显式关闭默认源——三者错一个，Composer 就静默 fallback 到 packagist.org，根本不会碰你的私有地址。

repositories 里 type 必须是 "composer"，不是 "vcs"

当你用 Artifactory、Satis 或 Nexus 搭建了可被 Composer 直接访问的镜像服务（即能返回 packages.json 的静态或动态接口），type 必须设为 "composer"。写成 "vcs"、"git" 或留空，Composer 会直接跳过该条目，不报错也不提示。

常见错误：

把 Satis 镜像 URL 写进 "type": "vcs" —— 它不是 Git 仓库，是 Composer 协议服务
Artifactory 创建了 Generic 类型仓库，却在 repositories 中声明 "type": "composer" —— 后端不支持，请求返回 404 或解析失败
URL 末尾漏掉斜杠 /，例如写成 "https://satis.example.com" 而非 "https://satis.example.com/" —— Composer 会拼出 /packages.json 变成 https://satis.example.com/packages.json，404

必须显式禁用 packagist.org，否则私有包永不命中

Composer 默认行为是：先查 packagist.org，查不到再 fallback 到 repositories 列表。哪怕你只 require 一个私有包，它也坚持先连外网。所以项目级 composer.json 中，必须加这一行：

{"packagist.org": false}

注意：

Discussion Composer

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

下载

这行必须和 repositories 同级，不能嵌套在 config 或 scripts 下
键名是 packagist.org（带点、小写、无 s），写成 packagist、repos.packagist 或 repositories.packagist 全无效
不要手写 "packagist.org": false 在全局配置里（如 ~/.composer/config.json）—— 它只影响全局命令，不作用于项目 install/update

auth.json 域名 key 必须和 URL host 完全一致

如果私有源需要 HTTP Basic 认证（比如 GitLab、Bitbucket、自建 Nginx 代理），auth.json 中的域名 key 不是“看着像就行”，而是必须和 repositories.url 解析出的 host 字符串逐字匹配：

url 是 https://gitlab.example.com:8080/acme/utils.git → key 必须是 "gitlab.example.com:8080"
url 是 https://gitlab.example.com/acme/utils.git → key 必须是 "gitlab.example.com"（不含端口、协议、路径）
大小写敏感："GitLab.example.com" ≠ "gitlab.example.com"
路径中的子域不算 host：https://packages.gitlab.example.com/ 的 host 是 "packages.gitlab.example.com"，不是 "gitlab.example.com"

认证字段必须是 http-basic 结构，且 password 字段放 Token（如 glpat-xxx 或 Bitbucket App Password），不能放明文密码。

HTTPS 域名解析不走系统 DNS，重定向会直接失败

别指望改 /etc/hosts 或本地 DNS 就能让 Composer 访问内网私有源。Composer 发起 HTTP 请求时，直连 URL 中的域名，不做额外解析；而且它对 301/302 重定向极其敏感——如果 Nginx 把 https://packages.internal/ 重定向到 https://packages.internal/packages.json，Composer 会拒绝跟随，报 Invalid repository type 或静默跳过。

验证方式很简单：