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

直接用 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 update 或 composer install 时,GitHub API 调用就会走认证通道,速率限制升至每小时 5000 次。
基本上就这些——不复杂但容易忽略,设好 token 后 CI 构建、依赖拉取都会更稳更快。










