解决 composer 安装时出现的 SSL 证书问题

优先配置正确的CA证书路径可解决Composer安装PHP包时的SSL证书错误，具体方法包括：检查php.ini中openssl.cafile和curl.cainfo设置并指向有效证书文件，更新Composer版本，必要时使用国内镜像源加速。

在使用 Composer 安装 PHP 包时，遇到 SSL 证书错误是常见问题，通常表现为 “SSL: certificate verify failed” 或 “Could not resolve host: packagist.org” 等提示。这类问题多出现在 Windows 系统或本地开发环境中，主要原因是系统缺少有效的 CA 证书包或 PHP 配置不正确。以下是几种实用的解决方案。

检查并配置 php.ini 中的 openssl.cafile

PHP 在发起 HTTPS 请求时依赖 CA 证书来验证服务器身份。若未正确设置证书路径，就会导致 SSL 错误。

操作步骤：

• 找到当前使用的 php.ini 文件（可通过 php --ini 查看位置）
• 搜索 openssl.cafile 和 curl.cainfo
• 将它们指向一个有效的 CA 证书文件，例如：

openssl.cafile=C:\php\cacert.pem
curl.cainfo=C:\php\cacert.pem

如果没有证书文件，可从 https://www.php.cn/link/5fe4dadcdb001d8566cd20e6d8a20251 下载，并保存到指定路径。

更新 Composer 并重新安装

旧版本 Composer 可能存在兼容性问题。建议升级到最新版本：

php composer.phar self-update

如果问题依旧，尝试重新下载 Composer 官方安装器，确保来源可信且完整。

超能文献

超能文献是一款革命性的AI驱动医学文献搜索引擎。

123 查看详情

临时关闭 SSL 验证（仅限测试环境）

不推荐在生产环境使用，但可用于快速验证是否为证书问题：

composer config -g secure-http false

该命令会关闭全局 HTTPS 强制验证，可能导致安全风险，请务必在修复证书后恢复设置：

composer config -g secure-http true

使用国内镜像源（可选优化）

国内用户可切换 Packagist 镜像，减少网络问题：

composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/

这不仅能提升速度，还能避免部分因网络中间节点引起的 SSL 异常。

基本上就这些方法。优先推荐配置正确的 CA 证书路径，从根本上解决问题。临时关闭安全选项只是权宜之计，不应长期使用。

以上就是解决 composer 安装时出现的 SSL 证书问题的详细内容，更多请关注php中文网其它相关文章！