0

0

composer提示SSL证书验证失败怎么办_cacert.pem路径配置【方案】

穿越時空

穿越時空

发布时间:2026-01-06 14:53:02

|

486人浏览过

|

来源于php中文网

原创

最稳妥解法是修改 php.ini 中的 curl.cainfo 或 openssl.cafile 指向有效 cacert.pem;需下载 mozilla 官方证书、正确配置路径并重启服务,因 composer 的 cafile 配置不作用于 php 底层 https 调用。

composer提示ssl证书验证失败怎么办_cacert.pem路径配置【方案】

直接改 php.ini 里的 curl.cainfoopenssl.cafile 是最稳妥的解法,临时禁用 SSL 验证(composer config -g secure-http false)只适合离线调试,不建议长期用。

确认当前 PHP 使用的 CA 证书路径

Composer 依赖 PHP 的 cURL 和 OpenSSL 扩展验证 HTTPS,而它们默认从系统或 PHP 自身配置里找根证书。运行以下命令查看实际生效路径:

php -r "print_r(openssl_get_cert_locations());"

重点关注输出中的 default_cert_filecafile 字段。如果值为空、路径不存在,或指向一个过期/损坏的 cacert.pem,就会报 SSL 验证失败。

下载并配置有效的 cacert.pem

推荐使用 Mozilla 维护的权威证书包,比系统自带更及时:

Uni-CourseHelper
Uni-CourseHelper

私人AI助教,高效学习工具

下载
  • 访问 https://www.php.cn/link/5fe4dadcdb001d8566cd20e6d8a20251 下载最新 cacert.pem
  • 保存到一个固定路径,例如:/usr/local/etc/php/cacert.pemmacOS/Linux)或 C:phpextrassslcacert.pem(Windows)
  • 编辑你的 php.ini,添加或修改两行(二者选其一即可,优先用 curl.cainfo):
    curl.cainfo="/usr/local/etc/php/cacert.pem"
    openssl.cafile="/usr/local/etc/php/cacert.pem"
  • 重启 Web 服务或 CLI 环境,再执行 php -m | grep curlcomposer diagnose 验证是否生效

为什么不能只配 Composer 自己的 cafile?

Composer 的 config cafile(即 composer config -g cafile /path/to/cacert.pem)只影响 Composer 自身的 HTTP 请求,不控制 PHP 内部的 file_get_contents()stream_context_create() 等调用——而某些插件、脚本或依赖安装过程会绕过 Composer 的 HTTP 封装,直接走 PHP 底层,此时仍会因系统证书缺失报错。所以必须从 PHP 层统一配置。

Windows 下常见陷阱

Windows 用户容易踩两个坑:

  • 路径中用了反斜杠 却没加转义或没用双引号,导致 php.ini 解析失败,应写成:curl.cainfo="C:\php\extras\ssl\cacert.pem"curl.cainfo="C:/php/extras/ssl/cacert.pem"
  • PHP 版本混用:WAMP/XAMPP/手动安装的 PHP 可能有多个 php.ini(CLI 用一个,Apache 用另一个),务必确认你改的是 php --ini 显示的那一个

证书路径一旦配错,错误信息往往还是 “SSL certificate problem: unable to get local issuer certificate”,不会提示路径不存在——得靠 openssl_get_cert_locations() 实锤。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
composer是什么插件
composer是什么插件

Composer是一个PHP的依赖管理工具,它可以帮助开发者在PHP项目中管理和安装依赖的库文件。Composer通过一个中央化的存储库来管理所有的依赖库文件,这个存储库包含了各种可用的依赖库的信息和版本信息。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

161

2023.12.25

curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

454

2023.06.14

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

183

2023.10.30

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1385

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1159

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

830

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

460

2023.08.02

windows无法访问共享电脑
windows无法访问共享电脑

在现代社会中,共享电脑是办公室和家庭的重要组成部分。然而,有时我们可能会遇到Windows无法访问共享电脑的问题。这个问题可能会导致数据无法共享,影响工作和生活的正常进行。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2361

2023.08.08

PHP高性能API设计与Laravel服务架构实践
PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开,重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景,深入分析性能瓶颈定位与优化思路,帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

4

2026.03.04

热门下载

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

精品课程

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

共137课时 | 12.9万人学习

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

共6课时 | 11.3万人学习

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

共13课时 | 1.0万人学习

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

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