use-github-api 是 Composer 的配置项,用于控制是否通过 GitHub API 获取仓库版本信息,默认值为 true。当遇到 API 限流或内网无法访问 GitHub API 时,可设为 false,改用 git 克隆方式获取信息,但可能变慢;该配置不影响代码下载方式,仅优化元信息获取行为,多数项目无需修改。

在 Composer 的 config 配置中,use-github-api 是一个可选的布尔值配置项,用于控制 Composer 在访问 GitHub 上的包时是否使用 GitHub API 来获取信息。
作用说明
当你的项目依赖中包含托管在 GitHub 上的私有或公开仓库(例如通过 vcs 类型引入),Composer 需要获取版本信息(如标签、提交记录)来决定安装哪个版本。这时有两种方式:
- 使用 GitHub API:Composer 调用 GitHub 的 REST API 获取版本数据(比如 git tags)
- 直接克隆仓库:不通过 API,而是直接执行 git clone 来分析分支和标签
而 use-github-api 就是控制是否启用第一种方式。
配置方式
可以在 composer.json 中这样设置:
{
"config": {
"use-github-api": true
}
}
默认值为 true,即默认启用 GitHub API。
什么时候需要修改它?
- 如果你频繁遇到 GitHub API 限流(如提示 "API rate limit exceeded"),可以设为 false,让 Composer 改用 git 直接拉取信息
- 某些内网环境无法访问 GitHub API,但能走 git 协议(如 ssh://git@github.com/...),此时关闭该选项可能更稳定
- 关闭后可能会变慢,因为每次都要克隆部分仓库历史来分析版本
补充说明
这个设置只影响从 GitHub 获取元信息的行为,不影响实际代码下载方式。即使关闭 API,Composer 仍可能通过 git 克隆来安装包。
基本上就这些。这个配置属于优化类选项,大多数项目无需手动调整。










