COMPOSER_DISABLE_NETWORK=1 不禁用 SSL 校验,因 PHP stream/cURL 仍触发证书验证;需配合清空 openssl.cafile、启用 COMPOSER_NO_SSL=1 或彻底禁用源与插件才能真离线。

离线安装时 Composer 仍报 SSL 错误,说明它没真正离线——证书校验失败不是网络不通,而是 PHP 层仍在尝试远程验证元数据合法性。
为什么 COMPOSER_DISABLE_NETWORK=1 还报 certificate verify failed
因为 COMPOSER_DISABLE_NETWORK=1 只跳过远程包下载和仓库索引拉取,但不关闭 PHP stream/cURL 的证书校验逻辑。只要 Composer 内部调用了 file_get_contents() 或 curl_exec()(比如读取本地 composer.lock 中的 dist URL、触发 autoload 生成、甚至某些插件初始化),OpenSSL 就会按配置去校验证书链。
常见现象:vendor/ 和 composer.lock 都齐全,执行 composer install --no-plugins --no-scripts 仍卡在 SSL operation failed with code 1。
- 根本原因:PHP 的
openssl.cafile或curl.cainfo指向一个损坏/过期/不存在的证书文件,导致每次 HTTPS 相关调用都触发校验失败 - 关键线索:运行
php -r "print_r(openssl_get_cert_locations());",若ini_cafile显示路径但文件stat不存在,或default_cert_file是空字符串,就必然失败 - Windows 用户特别注意:
C:phpcacert.pem路径中反斜杠未转义时会被 PHP 当作控制字符处理,必须写成C:/php/cacert.pem或双反斜杠C:\php\cacert.pem
离线场景下真正有效的证书绕过方式
不能只靠 Composer 参数,必须从 PHP 底层切断证书校验触发点。以下任一方式可立即生效(仅限离线调试):
- 临时清空 CA 路径(推荐):
php -d openssl.cafile="" -d curl.cainfo="" composer install—— 强制让 OpenSSL 不加载任何证书,跳过链验证 - 设环境变量禁用 SSL(Linux/macOS):
COMPOSER_NO_SSL=1 php -d extension=openssl composer install—— 此变量由 Composer 自己识别,会跳过所有 TLS 校验逻辑 - Windows 下等效命令:
set COMPOSER_NO_SSL=1 & php -d extension=openssl composer install - 注意:
--no-secure-http在离线模式下完全无效,它只影响是否允许 HTTP 源,不干预证书验证
如何确认你已进入“真离线”状态
执行前先验证三件事,缺一不可:
使用 circleci/circleci-cli 和 circleci/orb-tools-orb SDK 来组合和验证 CircleCI Orbs。自动化 orb 打包、使用 conventional-changelog 进行语义化版本控制,并发布到 CircleCI Orb Registry。
- 运行
composer config --global repo.packagist false,彻底禁用全局源 fallback(否则 Composer 会悄悄回退到官方源并再次触发校验) - 检查
composer.json中没有repositories字段,或所有自定义源 URL 都是packagist.org以外的本地路径(如path类型) - 确保
vendor/下所有依赖包完整,且composer.lock中每个包的dist.sha256与本地文件哈希一致(可用sha256sum vendor/*/*/composer.json快速比对)
最后加 -vvv 运行:COMPOSER_NO_SSL=1 composer install -vvv 2>&1 | grep -E "(Downloading|Loading|SSL|https)",输出里不应出现任何 https:// 请求或 SSL 关键字。
容易被忽略的“伪离线”陷阱
最常踩的坑是以为删了 vendor/ 和 composer.lock 就能重装,结果 composer install 仍失败——因为你没关掉 Composer 插件或脚本的隐式联网行为。
- 必须显式禁用:
--no-plugins --no-scripts --no-autoloader,否则某些插件(如hirak/prestissimo)会在初始化时尝试连接镜像源 - 全局配置残留:运行
composer config --global --list | grep -i repo,若看到repos.packagist有值,哪怕设的是镜像地址,也会在离线时 fallback 并触发校验 - PHP 版本混用:CLI 用的是 PHP 8.1,但
composer.json里写了"platform": {"php": "8.3"},Composer 会尝试加载 8.3 的扩展(如 openssl),而该版本可能根本没配证书路径
离线安装不是“断网就行”,而是要让整个依赖解析链里没有任何一处还惦记着 HTTPS 和证书——这需要同时控制 Composer 行为、PHP 扩展加载、环境变量和配置项四个层面。










