配置 GitHub Token 可提升 Composer 请求限额至每小时 5000 次并访问私有仓库，需创建含 repo 和 read:packages 权限的 Personal Access Token，并通过 composer config –global github-oauth.github.com YOUR_TOKEN 将其写入全局配置，最后验证 auth.json 内容及安装测试。

在使用 Composer 安装私有仓库或频繁访问 GitHub 的公共仓库时，GitHub 会限制匿名请求速率。为避免请求失败或被限流，建议配置 GitHub 授权 Token。以下是具体配置方法。

为什么需要 GitHub Token

GitHub 对未认证的 API 请求有严格的频率限制（通常每小时 60 次）。Composer 在安装或更新依赖时会通过 GitHub API 获取信息，一旦超过限制就会报错。使用个人 Token 可将限额提升至每小时 5000 次，并支持访问私有仓库。

创建 GitHub Personal Access Token

前往 GitHub Settings → Developer settings → Personal access tokens → Tokens (classic) 或使用新的 Fine-grained Tokens。

• 点击 “Generate new token”
• 设置 Token 描述（如：composer-token）
• 权限选择：至少勾选 repo 和 read:packages
• 生成后请立即复制保存，页面关闭后无法再次查看

配置 Composer 使用 Token

使用以下命令将 Token 添加到 Composer 配置中，替换 YOUR_TOKEN 为实际值：

GitHub Copilot

GitHub ai编程工具，实时编程建议

48

查看详情

composer config –global github-oauth.github.com YOUR_TOKEN

该命令会将 Token 写入全局 Composer 配置文件（通常是 ~/.composer/auth.json），后续所有请求都会自动携带认证信息。

验证配置是否生效

• 检查 auth.json 文件是否存在且包含正确内容：

{
  “github-oauth”: {
    “github.com”: “YOUR_TOKEN”
  }
}

• 执行 composer update 或安装一个 GitHub 上的包测试是否仍出现 rate limit 错误

基本上就这些。配置完成后，Composer 就能稳定访问 GitHub 资源了。