0

0

composer如何解决SSL连接失败报错_composer证书验证配置方法【方案】

穿越時空

穿越時空

发布时间:2026-01-16 17:50:45

|

158人浏览过

|

来源于php中文网

原创

应配置 PHP 的 curl.cainfo 指向有效的 CA 证书文件,如下载 cacert.pem 并在 php.ini 中设置 curl.cainfo="/path/to/cacert.pem",或通过 composer config -g cafile 指定;禁用验证仅限临时调试。

composer如何解决ssl连接失败报错_composer证书验证配置方法【方案】

Composer 安装或更新时提示 SSL certificate problem 怎么办

这是 Composer 在 HTTPS 请求时无法验证服务器证书导致的报错,典型错误信息如:cURL error 60: SSL certificate problem: unable to get local issuer certificate。根本原因不是 Composer 本身问题,而是 PHP 的 cURL 扩展找不到可信 CA 证书路径,或系统证书库过旧/缺失。

检查并设置 openssl.cafilecurl.cainfo

PHP 需要知道去哪里找根证书(CA bundle),否则无法验证 HTTPS 站点(如 packagist.org)的身份。优先修改 php.ini

  • 找到当前 CLI 模式下生效的 php.ini:运行 php --ini 查看 Loaded Configuration File
  • 在该文件中添加或取消注释以下任一行(推荐用 curl.cainfo,它专用于 cURL):
    curl.cainfo = "C:\xampp\php\extras\ssl\cacert.pem"
    (Windows,XAMPP 示例)
    curl.cainfo = "/etc/ssl/certs/ca-certificates.crt"
    (Linux Debian/Ubuntu)
    curl.cainfo = "/usr/local/etc/openssl/cert.pem"
    macOS Homebrew PHP)
  • 保存后重启终端,执行 php -r "print_r(openssl_get_cert_locations());" 确认 curl_cainfo 显示为你设置的路径

临时绕过证书验证(仅限调试,禁止生产环境)

不推荐长期使用,但可快速验证是否为证书问题本身:

Spell.tools
Spell.tools

高颜值AI内容营销创作工具

下载
  • 全局禁用(危险):composer config -g secure-http false —— 这会让 Composer 允许 HTTP 包源,不解决 SSL 问题,且已从 Composer 2.2+ 默认禁用
  • 临时跳过证书校验(仅本次命令):curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false) 不适用于 Composer 命令行;正确做法是设环境变量
    export COMPOSER_CAFILE=/path/to/cacert.pem
    或 Windows:
    set COMPOSER_CAFILE=C:\path\to\cacert.pem
  • 最直接的临时方案(不改配置):composer install --no-secure-http(Composer 2.5+ 支持,但仅对包源协议降级,不解决 cURL 层证书失败)

下载并指定最新 CA 证书文件

如果系统没有维护良好的证书库,手动下载 Mozilla CA Bundle 是最稳妥的补救方式:

  • https://www.php.cn/link/5fe4dadcdb001d8566cd20e6d8a20251 下载 cacert.pem(纯文本 PEM 格式)
  • 保存到一个固定路径,例如:/opt/php/cacert.pem(Linux/macOS)或 C:\php\cacert.pem(Windows)
  • php.ini 中设置:
    curl.cainfo = "/opt/php/cacert.pem"
  • 或者通过 Composer 自身配置(优先级低于 php.ini,但无需改 PHP 配置):composer config -g cafile /opt/php/cacert.pem
  • 注意:每次更新 PHP 版本或重装环境,都要重新检查该路径是否存在、权限是否可读(尤其 Linux 上 www-data 用户需有读权限)
证书路径配置错一个字符、文件被覆盖成空、权限为 000、或用了过期的 PEM 文件——这些细节比“关掉验证”更容易被忽略,也更常导致反复失败。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2549

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1615

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1504

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1417

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1234

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1447

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

高德地图升级方法汇总
高德地图升级方法汇总

本专题整合了高德地图升级相关教程,阅读专题下面的文章了解更多详细内容。

2

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.7万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 7.1万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号