如何给Composer设置专属的HTTP Basic认证以访问私有镜像？-composer-PHP中文网

auth.json必须放在项目根目录或~/.composer/auth.json，权限设为600（linux/macos）或无bom（windows），域名须与请求host完全一致，且仅支持http-basic和github-oauth字段，手动编辑易出错，推荐用composer config命令生成。

如何给composer设置专属的http basic认证以访问私有镜像？

auth.json位置和权限必须严格匹配

Composer只在两个地方找auth.json：当前项目根目录（优先）、~/.composer/auth.json。它不会读vendor/、config/或子目录下的同名文件，也不会递归查找。

Linux/macOS下必须运行chmod 600 auth.json，否则Composer会静默忽略该文件；Windows上需确保文件无BOM、不带UTF-8签名。

项目级推荐：把auth.json放在和composer.json同级的目录下
全局配置慎用：composer config --global http-basic.packages.example.com user token会让所有项目共享凭据，CI中易泄露
auth.json必须加进.gitignore，绝不可提交到Git

域名必须与请求Host完全一致

Composer匹配认证时只看HTTP请求头里的Host字段，不解析协议、路径、端口，也不支持通配符。

比如仓库URL是https://packages.internal.org/api/v1，就得配packages.internal.org；填internal.org、https://packages.internal.org或packages.internal.org:443全都不生效。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

GitLab私有实例https://gitlab.company.com → 配gitlab.company.com
Nexus地址https://nexus.myorg.com/repository/composer/ → 配nexus.myorg.com
密码含$、!、@等shell特殊字符时，命令行执行要用单引号包裹：composer config http-basic.packages.example.com user 'p@ss$w!rd'

别在composer.json里硬编码凭证

往composer.json的repositories数组里加username/password字段完全无效——Composer根本不读这些字段。更危险的是，这等于把凭证明文塞进代码库。

也别改composer.json里的config.http-basic，那只是静态声明，不会触发认证头发送，composer install时照样401。

真正起作用的是auth.json或composer config http-basic.{domain}命令生成的内容
Git仓库必须用https://协议才能触发HTTP Basic Auth；git@地址走SSH，跟auth.json无关
验证是否生效：运行composer config --list | grep http-basic，看到对应域名才说明加载成功

401或404报错时先确认认证头是否发出

报401 Unauthorized不是密码错了，而是根本没发Authorization: Basic头；报404常是伪装——服务器返回HTML登录页，Composer试图解析JSON失败，日志里会出现Failed to decode response: Syntax error。

用composer diagnose检查输出里有没有Checking http-basic authentication及列出的域名
临时验证连通性：curl -v -u user:pass https://packages.example.com/packages.json
多个私有源要分别配，{"http-basic": {"a.com": {}, "b.net": {}}}这样写才共存，重复执行composer config会覆盖同一域名的旧值

实际最易被忽略的是：Composer对auth.json格式零容忍——多一个逗号、用单引号代替双引号、带注释、JSON缩进不规范，它都会静默跳过，且不报错。