Composer使用GitLab搭建私有仓库配置流程-composer-PHP中文网

composer引入gitlab私有仓库需三要素：repositories顶层数组中设"type":"vcs"、url含.git后缀；auth.json置于~/.composer/且权限600，用http-basic匹配域名；require包名必须与私有库composer.json中name字段完全一致。

composer使用gitlab搭建私有仓库配置流程

Composer 不能直接“搭建” GitLab 私有仓库——GitLab 是代码托管平台，Composer 只是依赖管理工具。真正要做的，是让 Composer 能从你的 GitLab 仓库里拉取包，这靠的是 vcs 类型仓库 + 正确认证 + 包名对齐，三者缺一不可。

composer.json 的 repositories 必须写对位置和结构

repositories 是顶层数组，不是嵌套在 config、scripts 或其他字段下。写错位置，Composer 完全无视。

"type" 必须是 "vcs"，不是 "git"、"gitlab" 或留空；写成 "gitlab" 会静默跳过（某些旧教程误导严重）
"url" 必须是能直接 git clone 的地址，含 .git 后缀：例如 https://gitlab.example.com/acme/utils.git 或 git@gitlab.example.com:acme/utils.git
不能写成网页地址：https://gitlab.example.com/acme/utils（缺 .git）或 https://gitlab.example.com/acme/utils/-/tree/main（是 HTML 页面）
如果只加了私有源，默认会关闭 packagist.org 隐式源，必须显式补一条兜底：{"type": "composer", "url": "https://packagist.org", "packagist": false}，否则其他公共包会找不到

auth.json 必须放对路径且权限严格

90% 的认证失败，不是 Token 无效，而是文件没被读到——Composer 对路径和权限极其敏感，且不报错。

git摸鱼周报自动化

生成周报：读取本机 Git 仓库最近一周的提交记录，按项目分类提炼总结，生成标准周报格式，通过微信推送并返回给用户。触发词：周报、weekly report、git总结、提交记录总结、工作周报。

下载

Linux/macOS 路径只能是：~/.composer/auth.json（不是项目根目录下的 auth.json）
Windows 路径只能是：%APPDATA%\Composer\auth.json
权限必须是 600：chmod 600 ~/.composer/auth.json，否则 Composer 直接忽略该文件
内容必须用 "http-basic" 字段，域名 key 和仓库 URL 的 host 完全一致（不含协议、端口、路径），例如："gitlab.example.com" 对应 https://gitlab.example.com/acme/utils.git
Token 类型必须是 Personal Access Token，scope 至少含 read_repository；glpat- 前缀不能漏

require 的包名和版本必须与私有库 composer.json 严丝合缝

Composer 不按 Git 路径找包，只比对私有库根目录 composer.json 里的 "name" 字段。差一个字符，就 Could not find package。

假设私有库的 composer.json 写的是 {"name": "acme/utils"}，那主项目 require 就必须写 "acme/utils": "dev-main"
不能写成 "Acme/utils"（大小写敏感）、"acme-utils"（连字符 ≠ 斜杠）、"utils"（缺 vendor 段）
分支必须加 dev- 前缀："dev-main" 可行，"main" 或 "*" 会被当模糊约束，去 Packagist 查，查不到就失败
如果私有库没打任何 tag，唯一可用版本就是 dev-main（或 dev-master，取决于默认分支名）

验证是否真能走通，别信“配置完了”

很多问题表面是 Composer 报错，实际是 Git 层根本连不通。最可靠验证方式是绕过 Composer，直连 Git。

执行：git ls-remote -h https://gitlab.example.com/acme/utils.git，能列出分支说明 HTTPS + Token 可用
执行：git ls-remote -h git@gitlab.example.com:acme/utils.git，能列出分支说明 SSH 密钥已配好
如果 composer install 报 Authentication failed，但上面命令成功，大概率是 auth.json 路径或权限错了
如果报 No valid composer.json was found，说明 Git 克隆成功了，但私有库根目录没有合法 composer.json（比如放错位置、语法错误、缺 name 字段）