composer提示“The openssl extension is required”错误的解决方案

冰火之心
发布: 2025-11-26 14:28:58
原创
258人浏览过
首先检查并启用PHP配置文件中的OpenSSL扩展,确保php.ini中extension=openssl未被注释,然后确认CLI与Web环境使用相同PHP版本及配置,Windows用户需补全依赖DLL文件,Linux用户通过包管理器安装php-openssl扩展,最后重启服务并验证OpenSSL是否加载成功。

composer提示“the openssl extension is required”错误的解决方案

当你在使用 Composer 时遇到 "The openssl extension is required" 错误,说明 PHP 环境中未启用 OpenSSL 扩展。这个扩展是 Composer 下载和验证包所必需的,尤其是在通过 HTTPS 与 Packagist 通信时。以下是解决该问题的几个实用步骤。

1. 检查 php.ini 文件是否启用 OpenSSL

打开你当前 PHP 版本对应的 php.ini 配置文件。可以通过以下命令查看位置:

php --ini

在输出中找到 Loaded Configuration File 对应的路径,用文本编辑器打开该文件,搜索:

;extension=openssl

如果前面有分号(;),说明被注释了,去掉分号使其生效:

extension=openssl

保存后重启 Web 服务(如 Apache 或 Nginx)或命令行再试。

2. 确认使用的 PHP 版本正确

某些系统可能安装了多个 PHP 版本(如 CLI 和 Web 使用的不同版本)。运行以下命令检查命令行使用的 PHP:

php -m | grep openssl

如果输出包含 openssl,说明 CLI 已启用;如果没有,可能是 php.ini 路径不对,或该版本未安装扩展。

也可以运行 php -i | grep 'Configuration File' 再次确认加载的是哪个配置文件。

3. 在 Windows 上安装 OpenSSL 扩展

Windows 用户需确保 PHP 安装目录下的 ext 文件夹中存在 php_openssl.dll 文件,并且系统环境变量中包含了 PHP 的 DLL 依赖路径。

还需确认以下 DLL 是否存在于系统路径或 PHP 目录中:

新CG儿
新CG儿

数字视觉分享平台 | AE模板_视频素材

新CG儿 412
查看详情 新CG儿
  • libeay32.dll
  • ssleay32.dll
  • 或更新版本的 libcrypto-*.dll 和 libssl-*.dll

若缺失,可从官方 PHP Windows 发行包中补全,或重新下载完整版 PHP 包替换。

4. Linux 系统安装 OpenSSL 扩展

在 Ubuntu/Debian 系统上,运行:

sudo apt-get install php-openssl

或根据你的 PHP 版本指定:

sudo apt-get install php8.1-openssl

在 CentOS/RHEL 系统中:

sudo yum install php-openssl

或使用 dnf(较新版本):

sudo dnf install php-openssl

安装完成后重启 PHP 服务或 Web 服务器。

5. 验证问题是否解决

执行以下命令检查 OpenSSL 是否已加载:

php -m | grep openssl

如果看到输出 openssl,再尝试运行 Composer 命令,错误应该消失。

基本上就这些。只要确保 PHP 正确启用了 OpenSSL 扩展,Composer 就能正常工作。不复杂但容易忽略配置细节。

以上就是composer提示“The openssl extension is required”错误的解决方案的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

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