配置 GitHub Access Token 可提升 Composer 的 API 调用限额。首先在 GitHub Tokens 页面创建具有 repo 和 read:packages 权限的 Personal Access Token,复制生成的 token 后执行 composer config --global github-oauth.github.com YOUR_ACCESS_TOKEN 将其添加到 Composer 全局配置中,该操作会更新 ~/.config/composer/config.json 或 ~/.composer/config.json 文件,加入 github-oauth 认证信息。配置完成后,运行 composer update 等命令不再出现 “API rate limit exceeded” 错误即表示生效,可通过 composer config --global --list 验证配置条目,认证后请求享有最高每小时 5000 次的 API 调用额度,显著提升依赖解析效率,尤其有利于高频操作和 CI/CD 环境。

Composer 默认使用 GitHub API 来获取公开仓库的元信息,比如版本标签和分支。未认证的请求会受到较低的速率限制(通常每小时 60 次),而通过配置 GitHub Access Token 可以显著提升这个限制(最高可达每小时 5000 次)。
生成 GitHub Access Token
访问 GitHub Tokens 页面 创建一个 Personal Access Token:
- 点击 "Generate new token"
- 选择 "Fine-grained tokens" 或旧版 "Personal access tokens (classic)"
- 确保勾选 repo 和 read:packages 权限(如果是 classic token)
- 复制生成的 token,注意页面关闭后无法再次查看
将 Token 配置到 Composer
使用以下命令将 GitHub token 添加到 Composer 的全局配置中:
composer config --global github-oauth.github.com YOUR_ACCESS_TOKEN这条命令会在 Composer 的全局配置文件(通常是 ~/.config/composer/config.json 或 ~/.composer/config.json)中添加:
验证配置是否生效
运行任意涉及 GitHub 的命令,如:
composer update如果不再出现类似 “API rate limit exceeded” 的警告,说明配置成功。也可以通过查看调试输出确认:
composer config --global --list检查是否有 github-oauth.github.com 条目。
基本上就这些。配置完成后,Composer 在请求 GitHub 资源时会携带认证信息,从而享受更高的 API 调用限额,加快依赖解析速度,特别是在频繁操作或 CI/CD 环境中效果明显。










