composer必须同时配置http-proxy和https-proxy，因所有主流仓库全量走https，而composer严格分协议路由：http-proxy仅处理http请求，https-proxy才建立https的connect隧道；缺一则对应协议请求fallback直连，导致“loading composer repositories”卡住、超时或502。
Composer为什么必须同时配http-proxy和https-proxy
因为Packagist、GitHub等所有主流仓库全量走HTTPS，而Composer对代理是严格分协议路由的：http-proxy只处理HTTP请求，https-proxy才用于建立HTTPS的CONNECT隧道。漏掉任一字段，对应协议的请求就会fallback到直连——结果就是composer install卡在“Loading composer repositories”，无报错但超时或502。
关键点：
-
https-proxy值必须是http://开头（哪怕代理本身监听TLS端口），填https://127.0.0.1:8080或裸地址127.0.0.1:8080都会静默失败 - 密码含
@、/、:必须URL编码，例如pa@ss/word要写成pa%40ss%2Fword - 必须加
-g（全局配置），否则换项目目录就失效 - Composer完全忽略系统
HTTP_PROXY环境变量，只认自己配置的两个字段
WAF拦截时User-Agent和Referer怎么改才有效
阿里云、清华镜像等常见WAF会基于User-Agent（如Composer/2.5.8）或路径（如/p/laravel/framework/）触发规则910100（爬虫UA）或933150（路径遍历）。绕过不是靠“换UA”，而是让请求看起来像真实浏览器访问页面。
实操要点：
- 在项目
composer.json里加"user-agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36"——Composer 2.2+才支持，旧版无效 - 全局加Referer：
composer config -g http.extra-options "--header 'Referer: https://mirrors.aliyun.com/composer/'" - 禁用并行下载降低请求密度：
composer config -g process-timeout 300+composer config -g use-include-path false - 私有源URL务必以
/结尾，否则Composer拼接路径可能变成/composerpackages.json被当路径遍历拦截
NTLM代理环境下Composer怎么连上
Windows域环境下的NTLM代理，Composer原生不支持，直接设http-proxy会返回407 Proxy Authentication Required或Unable to connect to http://repo.packagist.org。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
唯一可行方案是引入中转代理：
- 用
cntlm或px监听127.0.0.1:3128，由它处理NTLM认证 - 再让Composer连这个本地地址：
composer config -g http-proxy http://127.0.0.1:3128和https-proxy http://127.0.0.1:3128 - 验证中转是否生效：
curl -x http://127.0.0.1:3128 -I https://packagist.org/packages.json，若仍报407说明中转层没配好
pre-file-download事件能做什么
这个事件在Composer真正发起HTTP请求前触发，是修改请求头、替换URL、注入认证的最后机会，比全局配置更灵活，也更精准。
典型用途：
- 为私有包仓库自动注入Bearer Token：
$event->getContext()->setHeaders(['Authorization' => 'Bearer xxx']) - 把官方dist URL动态替换成CDN地址或内网缓存路径
- 记录每次下载的URL和耗时，用于性能分析
- 结合本地文件检查，实现离线模式：若
file_exists($cachePath)则$event->setFile($cachePath)
注意：它不干预依赖解析阶段，只作用于实际文件下载环节；插件需注册EventSubscriberInterface并监听ScriptEvents::PRE_FILE_DOWNLOAD。
