Composer想管理Gitee上的私有库项目？OAuth鉴权在码云平台的适配【实操】-composer-PHP中文网

gitee私有库必须配置为"type":"vcs"、url含".git"后缀且使用oauth2+个人令牌鉴权，否则composer install会因认证失败或格式错误报could not fetch；裸地址https://gitee.com/org/repo无效，因composer不识别网页链接，仅支持可git clone的带鉴权url。

composer想管理gitee上的私有库项目？oauth鉴权在码云平台的适配【实操】

直接说结论：Gitee 私有库必须用 oauth2 + 个人令牌（Personal Access Token），且 URL 必须带 .git 后缀、声明为 vcs 类型，否则 composer install 会卡在认证环节或报 Could not fetch。

为什么填 `https://gitee.com/org/repo` 就失败？

Gitee 不接受裸网页地址作为仓库源。Composer 默认走匿名 HTTPS，而私有库需要鉴权；它不会自动把你的浏览器登录态透传过去。

错误写法："url": "https://gitee.com/your-org/private-pkg"（缺 .git，非可克隆格式）
正确写法："url": "https://oauth2:YOUR_TOKEN@gitee.com/your-org/private-pkg.git"
必须加 type: "vcs"，否则 Composer 不识别这是 Git 源
令牌权限必须勾选 projects（不是 user_info 或 notifications）

`auth.json` 里该用 `http-basic` 还是 `bearer`？

两者都行，但行为不同：

Git Pushing

使用约定式提交信息暂存、提交和推送git更改。当用户想要提交和推送更改、提到推送到远程、或要求保存并推送工作时触发。也适用于用户说“推送更改”、“提交并推送”、“推送这个”、“推送到github”或类似git工作流程请求时。

下载

http-basic 是最稳的：Gitee 接受 username 为 token、password 留空的模拟 Basic Auth 方式
示例：
```
{ "http-basic": { "gitee.com": { "username": "glpat-xxxxxxxxxxxxxxxxxxxx", "password": "" } } }
```
bearer 更语义化，但部分旧版 Composer（{ "bearer": { "gitee.com": "glpat-xxxxxxxxxxxxxxxxxxxx" } }
推荐优先用 http-basic，兼容性好，CI 场景下也容易通过 COMPOSER_AUTH 注入

require 时提示 `could not find package` 怎么办？

这不是网络或权限问题，而是包注册逻辑没对上：

检查私有库根目录下的 composer.json 中 name 字段是否和你 require 的完全一致（包括大小写、斜杠方向）
Gitee 上必须打语义化 tag（如 v1.0.0），dev-main 或 dev-master 默认不可见——除非你在根项目 config 里显式启用：
```
"config": { "minimum-stability": "dev", "prefer-stable": true }
```
确认 tag 已推送到远程：git push origin v1.0.0，别只本地打 tag
运行 composer clear-cache，避免旧元数据干扰