如何为Composer配置HTTP Basic认证_访问受密码保护的私有Composer仓库

12次阅读

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

如何为Composer配置HTTP Basic认证_访问受密码保护的私有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 替换为你的私有仓库域名,usernamepassword 替换为实际的登录凭据。

这条命令会修改当前项目的 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 installcomposer update,如果不再提示 401 错误,并能正常下载包,说明配置成功。

若仍失败,可启用调试模式查看详细请求信息:

composer install -v

基本上就这些。只要域名匹配且凭据正确,Composer 会自动处理认证过程。

text=ZqhQzanResources