配置私有 Composer 仓库 HTTP Basic 认证需通过 composer config http-basic.域名 用户名 密码 命令或手动创建 auth.json 文件,确保凭据正确且域名匹配,Composer 即可在请求时自动携带认证信息,完成私有包下载。

当你的私有 Composer 仓库(如 Satis、Private Packagist 或自建的 HTTP 服务)启用了 HTTP Basic 认证时,你需要让 Composer 在请求时提供用户名和密码。以下是配置方法。
使用 composer config 添加认证信息
你可以通过 composer config 命令为特定域名设置 HTTP Basic 认证凭据,Composer 会在后续请求中自动附加这些凭证。
执行以下命令:
composer config http-basic.your-private-repo.com username password将 your-private-repo.com 替换为你的私有仓库域名,username 和 password 替换为实际的登录凭据。
这条命令会修改当前项目的 auth.json 文件(或全局的),内容如下:
{ "http-basic": { "your-private-repo.com": { "username": "username", "password": "password" } } }手动创建 auth.json 文件
你也可以手动在项目根目录创建 auth.json 文件来管理认证信息。
确保该文件与 composer.json 在同一目录下,内容格式与上文一致。
注意:不要将 auth.json 提交到版本控制系统。建议在 .gitignore 中添加:
/auth.json全局配置(可选)
如果你有多个项目使用同一个私有仓库,可以将认证信息保存在全局配置中:
composer config --global http-basic.your-private-repo.com username password这会把凭据写入 Composer 的全局 auth.json(通常位于 ~/.config/composer/auth.json 或 ~/composer/auth.json)。
验证是否生效
运行 composer install 或 composer update,如果不再提示 401 错误,并能正常下载包,说明配置成功。
若仍失败,可启用调试模式查看详细请求信息:
composer install -v基本上就这些。只要域名匹配且凭据正确,Composer 会自动处理认证过程。










