如何通过Composer config命令设置GitHub的OAuth token?(API速率限制)

15次阅读

使用 composer config -g github-oauth.github.com 全局配置 GitHub OAuth Token,可将 API 限速从每小时 60 次提升至 5000 次,加速依赖安装与更新,并避免未认证请求限制。

如何通过Composer config命令设置GitHub的OAuth token?(API速率限制)

直接用 composer config 命令设置 GitHub OAuth token,能有效绕过未认证请求的 API 速率限制(默认每小时 60 次),提升依赖安装和更新速度。

获取 GitHub Personal access Token

前往 GitHub Settings → Developer settings → Personal access tokens → Tokens (classic),点击 Generate new token → Generate new token (classic)

  • 勾选 repo(读取私有/公开仓库)和 read:packages(如果用 GitHub Packages)
  • Token 描述建议写明用途,如 composer-github-auth
  • 生成后立即复制保存——页面关闭后无法再次查看明文

全局设置 token(推荐)

运行以下命令,将 token 写入 Composer 全局配置(~/.composer/auth.json):

composer config -g github-oauth.github.com 

✅ 这样所有项目都会自动使用该 token,无需重复配置;Composer 会自动在 GitHub API 请求头中带上认证信息。

为单个项目设置(可选)

进入项目根目录,执行(不加 -g):

composer config github-oauth.github.com 

⚠️ 此操作会把 token 写入项目下的 auth.json(通常在 composer.json 同级),注意:不要提交到 Git。建议把 auth.json 加入 .gitignore

验证是否生效

运行以下命令查看当前配置:

composer config -g github-oauth.github.com

或检查全局 auth 文件内容:

cat ~/.composer/auth.json

正常应看到类似:

{"github-oauth": {"github.com": "ghp_..."}}

之后执行 composer updatecomposer install 时,GitHub API 调用就会走认证通道,速率限制升至每小时 5000 次。

基本上就这些——不复杂但容易忽略,设好 token 后 CI 构建、依赖拉取都会更稳更快。

text=ZqhQzanResources