如何使用Composer命令在安装时配置特定的存储库代理身份验证-composer-PHP中文网

应通过auth.json文件或composer config命令配置http basic auth，域名须与仓库url主机名完全一致，文件权限设为600且不可提交至git；git仓库推荐用git credential helper而非http-basic。

如何使用composer命令在安装时配置特定的存储库代理身份验证

composer install 时如何设置私有仓库的 Basic Auth

Composer 默认不会自动读取环境变量或全局配置里的认证信息，私有 Packagist 或 Git 仓库需要显式提供凭证才能拉取包。最稳妥的方式是在 auth.json 中声明，而非拼接 URL 或硬编码密码。

auth.json 必须放在 Composer 配置作用域内：项目根目录（优先）、COMPOSER_HOME 目录（如 ~/.composer/auth.json），且权限需设为 600（否则 Composer 会忽略）
格式必须严格：顶层是 {"http-basic": {...}}，键为仓库域名（不含协议和路径），值为含 username 和 password 的对象

示例：

{
  "http-basic": {
    "packages.example.com": {
      "username": "token",
      "password": "ghp_abc123..."
    }
  }
}

避免把 token 写进 composer.json 的 repositories 字段里——这会导致凭证被提交到代码库，且 Composer 不会解析该处的变量或占位符

使用 composer config 设置仓库认证（临时或调试用）

如果只是单次调试或 CI 环境中临时注入，可用 composer config 命令写入当前项目配置，它会自动更新 auth.json（或创建）。

Discussion Composer

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

下载

命令格式：composer config http-basic.packages.example.com username password
注意域名必须与 composer.json 中 repositories 的 url 主机名完全一致（比如 https://packages.example.com/api 对应 packages.example.com，不是 api.packages.example.com）
该命令不支持在 URL 中嵌入认证（如 https://user:pass@packages.example.com），Composer 从 2.0 起已弃用这种写法，会报 Invalid credentials 错误

Git 仓库（如 GitHub/GitLab）的 token 认证怎么配

对 Git 类仓库，Composer 实际调用的是系统 git 命令，所以要走 git 的 credential helper 机制，而不是 http-basic。

GitHub 推荐用 gh auth login（CLI v2+）或配置 git config --global credential.helper store 后手动执行一次 git clone 触发凭据保存
GitLab 可通过 git config --global url."https://oauth2:<token>@gitlab.example.com".insteadOf "https://gitlab.example.com"</token> 实现 token 注入
若仍报 401，检查是否启用了 2FA：GitHub 的 Personal Access Token 必须勾选 repo 权限；GitLab 的需有 read_api 和 read_repository
不要在 composer.json 的 repositories.type=git 的 url 中写 https://token@...——git 会拒绝解析，且 token 泄露风险极高

为什么 composer install 仍提示 authentication required

常见原因不是配置漏了，而是作用域或解析失败。

运行 composer config --list 查看实际生效的 auth.json 路径，确认文件存在且可读
用 composer diagnose 检查输出里是否有 Authentication configured 提示；若没有，说明 auth.json 未被加载（权限不对、路径错、JSON 格式错误）
私有仓库 URL 若带子路径（如 https://example.com/packagist），认证域必须是 example.com，不是 example.com/packagist
某些企业镜像（如 Nexus Repository Manager）要求额外 header，此时需改用 composer config repo.packages.example.com options.http.headers 手动加 Authorization，但这是例外场景，Basic Auth 够用时不建议绕过标准流程

实际操作中，最容易被忽略的是 auth.json 文件权限和域名匹配精度——少一个点、多一个路径段，或者忘记 chmod 600，都会让整个认证静默失效。