Composer默认启用secure-http,但仅当配置为true且所有源URL以https://开头时才阻断不安全连接;否则静默降级HTTP,易致中间人劫持。

Composer 默认启用 HTTPS,但仅当 secure-http 配置为 true 且所有源 URL 以 https:// 开头时,才真正阻断不安全连接;否则它会静默降级到 HTTP,这在内网或调试场景中极易被忽略,导致中间人劫持风险。
为什么 composer install 有时仍走 HTTP?
根本原因不是 Composer 本身不支持 HTTPS,而是配置未生效或被覆盖:
-
composer.json中的"config": {"secure-http": true}只影响当前项目,若未提交或被COMPOSER_HOME/config.json全局配置覆盖,则无效 - 私有仓库 URL 写成
http://your-private-repo.com时,secure-http不会自动重写协议,而是直接报错或跳过验证(取决于 Composer 版本) - 镜像源配置错误:比如阿里云镜像 URL 写成
http://mirrors.aliyun.com/composer/(少一个s),实际请求 HTTP,但 Composer 不校验证书有效性,只校验响应状态码 - 某些旧版 Satis 或 Nexus 搭建的私有源未启用 TLS,而客户端又未显式禁用
verify_peer,会导致连接失败而非降级
如何验证当前连接是否真走 HTTPS?
别信配置文件,要看真实网络行为:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 加
-vvv参数运行composer install,搜索日志中类似Downloading https://packagist.org/packages.json的行——注意是https,不是http - 用
strace -e trace=connect,sendto php composer.phar install 2>&1 | grep -E 'connect|https'(Linux)确认 socket 连接目标端口是否为 443 - 检查
composer show --verbose输出中的dist.url字段:若值为http://开头,说明该包仍从非加密源下载,哪怕主仓库是 HTTPS - 对私有源,手动
curl -I https://your-private-repo.com/packages.json确认能返回200且无证书警告;若需跳过证书验证(仅测试环境),必须显式设"options": {"ssl": {"verify_peer": false}},不能靠降级
私有源强制 HTTPS 的三个硬性条件
光配 secure-http 不够,私有仓库要真正安全,必须同时满足:
- 服务端 Nginx/Apache 必须监听 443 并返回有效证书(自签名证书需在客户端信任链中,或配置
"verify_peer": true, "cafile": "/path/to/ca.pem") -
composer.json中仓库 URL 必须为完整https://地址,且不能带路径后缀(如https://repo.example.com/✅,https://repo.example.com/api/❌) - 若使用 Satis,其生成的
packages.json中所有dist.url必须重写为内网 HTTPS 地址(通过"archive": {"prefix-url": "https://packages.internal/"}配置),否则下载 ZIP 仍走 HTTP
最常被忽略的是 dist 层——即使仓库元数据走 HTTPS,实际下载的 ZIP 包可能来自 http://github.com/... 这类硬编码 URL。务必用 composer show vendor/package -v 检查 dist.url 协议,这才是最终文件传输的安全边界。

















