配置 GitHub 令牌可将 Composer 的 API 限速从 60 次/小时提升至 5000 次/小时,需生成含 repo 权限的 Personal Access Token,并通过 composer config -g github-oauth.github.com 全局配置。
Composer 配置 GitHub 令牌后,能绕过未认证请求的 60 次/小时 API 速率限制,直接提升到 5000 次/小时(认证后)。不配令牌时,composer install 或 composer update 经常卡在 Downloading https://api.github.com/... 并报 403 rate limit exceeded 错误——这不是网络问题,是 GitHub 的硬性限制。
怎么生成 GitHub Personal Access Token
GitHub 已弃用密码认证,必须用 Personal Access Token(PAT):
- 登录 GitHub → Settings → Developer settings → Personal access tokens → Tokens (classic)
- 点击 Generate new token → Generate new token (classic)
- Token description 填
composer-auth这类易识别名 -
至少勾选
repo权限(读私有库、fork、提交等都需要;仅 public_repo 不够,会导致 clone 私有 repo 失败) - 生成后立即复制保存——页面关闭后无法再次查看明文
怎么让 Composer 使用这个令牌
推荐用 composer config 全局写入,避免每次手动填或暴露在 auth.json 明文里:
composer config -g github-oauth.github.com
执行后,Composer 会把令牌写入全局配置文件(通常是 ~/.composer/auth.json),内容类似: