Composer 不支持为特定域名配置自定义 HTTP 头，因其配置体系未暴露 CURLOPT_HTTPHEADER 等底层 cURL 选项，未知配置键如 http-header.packages.example.com 会被静默忽略；可行替代方案仅有反向代理注入或自定义脚本拦截。
Composer 不支持为特定域名配置自定义 HTTP 头
Composer 没有提供类似 http-header.packages.example.com 这样的配置项，也不支持在 auth.json 或 config.json 中按域名设置 User-Agent、X-Request-ID 等自定义请求头。它的配置体系只暴露了 http-basic、proxy、github-oauth 等有限字段，CURLOPT_HTTPHEADER 属于底层 cURL 行为，未开放给用户直接控制。
为什么不能用 config 命令配自定义 header
执行 composer config http-header.packages.example.com "X-Source: ci" 会静默失败——Composer 解析配置时直接忽略未知键名，不会报错，也不会写入任何内容。你可以验证：composer config --list | grep http-header 永远为空。官方文档和源码中均无该配置项定义，所有尝试“仿照 http-basic 格式扩展”的做法都无效。
可行的替代方案只有两种
如果你必须为某个私有源（如 packages.internal.company）添加特定请求头，只能通过以下方式间接实现：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 在私有仓库前部署反向代理（如 Nginx），由代理层统一注入头：例如在 Nginx 配置中加
proxy_set_header X-Composer-Source $host;，这样所有来自 Composer 的请求都会带上该头 - 改用自定义脚本封装
composer命令，配合mitmproxy或Charles拦截并重写请求头——但这仅适用于开发/调试，不可用于 CI/CD - 修改 Composer 源码（不推荐）：定位到
src/Composer/Util/HttpDownloader.php中构建 cURL 句柄的位置，在curl_setopt($ch, CURLOPT_HTTPHEADER, ...)前插入逻辑，根据$urlhost 动态追加头——但每次 Composer 升级都会丢失改动，且破坏可维护性
别踩的坑：试图用环境变量或插件绕过限制
有人试过设 HTTP_HEADER_X_SOURCE=ci 或写 Composer 插件 hook pre-command-run，但这些都无法影响实际 HTTP 请求头。Composer 的网络层不读取此类环境变量，插件也无权限修改已初始化的 cURL 句柄。唯一真正生效的入口，是它内部调用 curl_setopt() 的那一刻——而这个点不在插件 API 覆盖范围内。
真正需要区分请求来源时，优先用 http-basic 凭据本身做标识（比如不同 CI job 用不同 token），比依赖 User-Agent 或自定义 header 更可靠、更易审计。
