在Composer配置文件中配置Git私有仓库的教程-composer-PHP中文网

私有git仓库能被composer正确拉取，前提是：repositories必须在composer.json顶层且type为"vcs"；url需带.git后缀并可手动git clone；包名严格匹配私有库composer.json中的name字段；分支需加dev-前缀；认证通过auth.json配置且域名精确一致；必须显式禁用packagist.org。

在composer配置文件中配置git私有仓库的教程

私有 Git 仓库能被 composer require 正确拉取，前提是 repositories 写对位置、type 设对值、URL 可直接 git clone，且认证已就绪——缺一不可。

repositories 必须在 composer.json 顶层，且 type 必须是 "vcs"

Composer 不会扫描子配置或嵌套结构。把 repositories 放进 config、scripts 或某个插件字段里，等于没写。

type 只能是 "vcs"：写成 "git"、"package" 或留空，Composer 都会静默跳过该仓库
URL 必须带 .git 后缀：例如 https://gitlab.example.com/acme/utils.git，写成 https://gitlab.example.com/acme/utils 会报 No valid composer.json was found
支持 SSH 和 HTTPS 两种格式，但必须确保本地环境能用对应方式 git clone 成功（可先手动试一遍）

包名必须和私有库 composer.json 中的 "name" 字段完全一致

Composer 不按 Git 路径推断包名，只严格匹配 name 字段内容。大小写、分隔符、vendor 段，差一个字符就 Could not find package。

Git Repo Reader

辅助阅读和快速理解 GitHub/Git 项目结构与核心价值的结构化方法论。当用户请求"分析这个 GitHub 项目"、"帮我读一下这个 repo"、"了解这个项目是做什么的"、 "怎么用这个项目"、"怎么跑这个项目"、"这个项目用了哪些技术"，或任何涉及 GitHub/Git 仓库阅读、理解、技术评估、快速上...

下载

假设私有库根目录 composer.json 写的是 {"name": "acme/utils"}，那主项目 require 就必须写 "acme/utils": "dev-main"
不能写成 "Acme/utils"、"acme-utils"、"utils" 或漏掉 acme/
分支名要加 dev- 前缀："dev-main" 可行，"main" 或 "*" 会被当成模糊约束，去 Packagist 查，查不到就失败

认证失败往往不是 token 无效，而是位置或格式错了

Composer 对认证配置极其敏感：路径错、权限错、字段名错、域名 key 不一致，都会静默忽略，不报错也不提示。

auth.json 必须放在全局路径：
Linux/macOS 是 ~/.composer/auth.json，Windows 是 %APPDATA%\Composer\auth.json（不是项目根目录）
权限必须是 600：chmod 600 ~/.composer/auth.json，否则 Composer 直接跳过
GitLab 必须用 http-basic 字段，结构为：{"http-basic": {"gitlab.example.com": {"username": "oauth2", "password": "glpat-xxx"}}}
域名 key（如 gitlab.example.com）必须和 repositories.url 中的 host 完全一致，不含协议、端口、路径；gitlab.example.com:8080 和 gitlab.example.com 是两个独立 key