Composer不支持“代理文件”,只认http-proxy和https-proxy全局配置或镜像源;二者必须同时设置且https-proxy值须以http://开头,否则HTTPS请求静默直连导致卡顿。

Composer 本身不支持“代理文件”加速导出——所谓“代理文件”是常见误解,真正起效的是 http-proxy 和 https-proxy 的全局配置,或切换为国内镜像源。
为什么“代理文件”说法不成立
Composer 没有读取单独代理配置文件(如 .proxyrc、proxy.conf)的机制。所有网络行为只受以下三者控制:全局 config.json 中的 http-proxy/https-proxy 字段、项目级 composer.json 的 config 段、或命令行临时传入(如 COMPOSER_HTTP_PROXY=...)。所谓“代理文件”通常指用户手动创建的 shell 脚本或环境变量文件,但 Composer 完全不读取 HTTP_PROXY 等系统环境变量——必须显式写入自己的配置。
composer config -g http-proxy 必须配对 https-proxy
只设 http-proxy 而漏掉 https-proxy 是卡在 “Loading composer repositories” 的最常见原因。Packagist、GitHub、所有镜像源均走 HTTPS,而 https-proxy 才负责建立 CONNECT 隧道。二者缺一,Composer 就静默 fallback 到直连,表现为无报错、无响应、curl error 35 或 TLS handshake failed。
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
-
https-proxy的值必须以http://开头(哪怕代理监听 HTTPS 端口),填https://127.0.0.1:8080或127.0.0.1:8080均无效 - 认证信息含
@、/、:时需 URL 编码,例如密码pa@ss/word→pa%40ss%2Fword - Windows 下若提示
Could not write to file,检查%APPDATA%\Composer\config.json是否可写,或加--no-plugins参数重试
镜像源比代理更稳,尤其在云服务器上
腾讯云、阿里云等 CVM 实例默认走内网 DNS 和就近 TLS 握手节点,配代理反而多一层失败点。直接切镜像源更可靠:
- 执行
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/(末尾/不可省) - 验证:运行
composer config -g repo.packagist,输出必须是完整 JSON,形如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 若项目
composer.json含repositories字段,它会覆盖全局配置;此时应删掉或注释该段,再重试
导出操作(如 create-project)也依赖同一套配置
composer create-project 内部第一步就是请求 https://repo.packagist.org/packages.json,和 install 完全共用 http-proxy/https-proxy 或 repo.packagist 配置。不存在“导出专用代理”——只要 install 能过,create-project 就不会卡在这一步。容易忽略的是:某些 CI 环境中,composer.json 里硬编码了私有仓库,导致 repo.packagist 配置被绕过,此时需检查 repositories 数组是否包含 "packagist": false 这类禁用项。

















