配置GitHub Token可提升API请求限额并访问私有仓库。需生成含repo和read:packages权限的Personal Access Token,并通过composer config --global github-oauth.github.com YOUR_TOKEN将其设为全局配置,完成后Composer将自动认证,避免限流提示。

在使用 Composer 安装或更新来自 GitHub 的私有仓库,或者频繁访问公共仓库时,GitHub 可能会要求你提供身份验证。这是因为 GitHub 对 API 请求有限流机制。通过为 Composer 配置 GitHub Token,可以提升请求限额并访问私有项目。
为什么需要配置 GitHub Token
Composer 在拉取 GitHub 上的包时(尤其是 dev 分支或私有仓库),会通过 GitHub API 获取信息。未认证的请求限制较低(每小时 60 次),而登录后可提升至每小时 5000 次以上。配置 Token 后,Composer 能更稳定地完成依赖安装。
如何生成 GitHub Token
你需要一个具有适当权限的 Personal Access Token(个人访问令牌):
- 登录 GitHub,进入 Settings → Developer settings → Personal access tokens → Tokens (classic)
- 点击 Generate new token(或“Generate new token (classic)”)
- 填写 Note(例如 “Composer on my server”)
- 选择有效期(建议选较短周期以保证安全)
- 勾选所需权限,一般只需勾选 repo 和 read:packages
- 滚动到底部,点击 “Generate token”
- 复制生成的 token(页面只显示一次)
将 Token 配置到 Composer
打开终端,运行以下命令:
composer config --global github-oauth.github.com YOUR_GITHUB_TOKEN其中 YOUR_GITHUB_TOKEN 替换为你刚才复制的 token。
这条命令会将 token 写入 Composer 的全局配置文件(通常位于 ~/.composer/auth.json),之后所有通过 Composer 访问 GitHub 的请求都会自动带上认证信息。
验证配置是否生效
你可以通过查看 auth.json 文件确认:
cat ~/.composer/auth.json应该能看到类似内容:
{ "github-oauth": { "github.com": "your_token_here" } }配置完成后,再次执行 composer install 或 composer update 时,就不会再出现 API 限流提示了。
基本上就这些。只要 token 不过期或被删除,Composer 就能持续使用它进行认证。如果将来 token 失效,只需重新生成并更新即可。










