应配置PHP的curl.cainfo指向有效的CA证书文件,如下载cacert.pem并写入php.ini,Linux/macOS可复用系统证书路径,严禁禁用SSL验证。

Composer报错“SSL certificate problem: unable to get local issuer certificate”怎么办
这是典型的 CA 证书缺失或路径未配置导致的 HTTPS 请求失败。Composer 默认通过 cURL 发起 HTTPS 请求(如 composer install),若系统 OpenSSL 无法验证证书链,就会中断并抛出该错误。
常见触发场景:Windows 上用官方安装器安装的 Composer、WAMP/XAMPP 环境、或自定义 PHP 配置中未设置 openssl.cafile。
- 先确认错误是否真实来自证书 —— 运行
composer diagnose,重点看 “The openssl extension is loaded” 和 “CA bundle is accessible” 两行 - 若提示 “CA bundle not found”,说明 PHP 不知道去哪里找根证书;不是网络问题,也不是代理问题
- 不要直接关掉 SSL 验证(如设
secure-http=false或curl.cainfo=空值),这会暴露包下载过程中的中间人风险
如何定位并设置正确的 curl.cainfo 路径
PHP 的 cURL 模块依赖 curl.cainfo ini 配置项指定 PEM 格式根证书文件位置。Composer 自身不管理证书,它完全复用 PHP-cURL 的配置。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 运行
php --ini查看当前生效的php.ini路径 - 打开该
php.ini,搜索curl.cainfo;若被注释或值为空,需手动补全 - 推荐使用 Mozilla 维护的 CA 包:https://www.php.cn/link/5fe4dadcdb001d8566cd20e6d8a20251,下载后保存为本地绝对路径(如
C:\php\cacert.pem或/etc/ssl/certs/cacert.pem) - 在
php.ini中写入:curl.cainfo = "C:\php\cacert.pem"
(Windows 注意用双引号包裹路径,含空格也必须包) - 改完重启 Web Server 或 CLI 环境,再运行
php -r "print_r(openssl_get_cert_locations());"验证路径是否生效
Linux/macOS 下更可靠的替代方案:复用系统 CA 存储
比起手动维护 PEM 文件,多数 Linux/macOS 发行版已预装可信根证书,并可通过 update-ca-trust 或 ca-certificates 工具更新。Composer 可直接对接。
- Debian/Ubuntu:确保已安装
ca-certificates包(默认都有),然后检查路径:php -r "print_r(openssl_get_cert_locations());"
中default_cert_file通常指向/etc/ssl/certs/ca-certificates.crt - 若该路径存在且非空,直接在
php.ini中设:curl.cainfo = "/etc/ssl/certs/ca-certificates.crt"
- macOS(Homebrew PHP):证书常位于
/opt/homebrew/etc/ca-certificates/cert.pem或/usr/local/etc/ca-certificates/cert.pem,用brew info openssl@3可确认 - 避免 symlink 错误:某些环境里
/etc/ssl/certs是符号链接,cURL 可能拒绝跟随;优先用realpath解析后再填入php.ini
临时调试时绕过证书校验的风险与边界
仅限离线开发、CI 测试或内网无证书环境使用,生产环境禁止。
- 全局禁用(不推荐):
composer config -g secure-http false—— 这会让 Composer 允许从 HTTP 源拉包,但不会修复 HTTPS 失败本身 - 真正跳过证书验证要改 PHP 层:
openssl.verify_peer = Off和openssl.cafile = "",但这等于关闭 TLS 安全保障 - 更安全的临时方案:用 Composer 的
--no-verify参数只跳过当前命令的签名检查(如composer install --no-verify),但不跳过 HTTPS 握手 - CI 场景建议统一镜像预装证书,而非运行时绕过;GitHub Actions 中可加一步:
sudo apt-get install -y ca-certificates
证书路径一旦配错,Composer 就会在每个远程请求上静默失败 —— 表现为超时、空响应或奇怪的 500 错误,而不是明确报 SSL 问题。务必用 composer diagnose 和 openssl_get_cert_locations() 交叉验证,别只信错误第一行。










