Composer默认强制启用secure-http(true),禁用HTTP是硬性拦截而非可选;报“secure-http is enabled”错误即因仓库URL为http://且未显式关闭该检查。

Composer 默认就只允许 HTTPS,禁用 HTTP 是强制行为,不是可选项;从 2.0 版本起,secure-http 默认为 true,任何 HTTP 协议的仓库地址(如 http://packagist.org 或自定义 http://my-repo.com)都会被直接拒绝,报错 Repository 'xxx' is not valid, secure-http is enabled。
为什么 composer install 报 “secure-http is enabled” 错误
这不是警告,是硬性拦截:Composer 拒绝加载任何 type: "composer" 且 URL 以 http:// 开头的仓库。常见触发点包括:
- 手动在
composer.json的repositories里写了"url": "http://mirrors.xxx.com/composer/" - 全局镜像配置错写成
http://(例如composer config -g repo.packagist composer http://mirrors.aliyun.com/composer/) - CI 环境中未清理旧配置,残留了项目级 HTTP 镜像
- 私有仓库临时调试用了 HTTP,但没加
--no-secure-http覆盖
如何临时绕过 secure-http 检查(仅调试用)
生产环境绝不推荐,仅用于验证是否真由 HTTPS 限制导致失败:
- 单次命令跳过:
composer install --no-secure-http - 全局关闭(危险!不建议):
composer config -g secure-http false - 项目级关闭(仍危险,且会提交到 Git):
composer config secure-http false
注意:--no-secure-http 仅对当前命令生效,不会改配置;而 config secure-http false 会写入 composer.json,下次 composer install 仍走 HTTP,除非手动 --unset。
如何正确配置国内镜像源(必须 HTTPS + 末尾 /)
镜像源必须满足三个条件,缺一就会 fallback 到官方 HTTP 地址并触发 secure-http 拒绝:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 键名严格为
repo.packagist(不是repos.packagist,也不是repositories) - type 值必须显式写
composer(不能省略或写错) - URL 必须以
https://开头、且末尾带/(例如https://mirrors.aliyun.com/composer/)
正确命令只有一行:composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/。运行后用 composer config -g repo.packagist 验证输出是否为完整 JSON,否则就是没生效。
内网私有仓库用 HTTP 怎么办
如果公司内网只有 HTTP 私有源,又无法启用 HTTPS,唯一合规做法是:在该仓库所在项目的 composer.json 中显式关闭安全检查,并限定作用域:
- 先确保仓库定义在
repositories数组首位 - 在同一文件中添加:
"secure-http": false(注意:这是项目级开关,不污染全局) - 或者更精准地,只对特定仓库禁用:
"repositories": [{"type": "composer", "url": "http://intranet/repo/", "options": {"secure-http": false}}](Composer ≥2.2 支持)
这种写法不会影响其他项目,也不会让 Packagist 回退到 HTTP;但务必确认该内网源无中间人风险——secure-http: false 是信任前提下的主动降级,不是容错机制。










