首先检查并启用PHP配置文件中的OpenSSL扩展,确保php.ini中extension=openssl未被注释,然后确认CLI与Web环境使用相同PHP版本及配置,Windows用户需补全依赖DLL文件,Linux用户通过包管理器安装php-openssl扩展,最后重启服务并验证OpenSSL是否加载成功。

当你在使用 Composer 时遇到 "The openssl extension is required" 错误,说明 PHP 环境中未启用 OpenSSL 扩展。这个扩展是 Composer 下载和验证包所必需的,尤其是在通过 HTTPS 与 Packagist 通信时。以下是解决该问题的几个实用步骤。
打开你当前 PHP 版本对应的 php.ini 配置文件。可以通过以下命令查看位置:
php --ini在输出中找到 Loaded Configuration File 对应的路径,用文本编辑器打开该文件,搜索:
;extension=openssl如果前面有分号(;),说明被注释了,去掉分号使其生效:
extension=openssl保存后重启 Web 服务(如 Apache 或 Nginx)或命令行再试。
某些系统可能安装了多个 PHP 版本(如 CLI 和 Web 使用的不同版本)。运行以下命令检查命令行使用的 PHP:
php -m | grep openssl如果输出包含 openssl,说明 CLI 已启用;如果没有,可能是 php.ini 路径不对,或该版本未安装扩展。
也可以运行 php -i | grep 'Configuration File' 再次确认加载的是哪个配置文件。
Windows 用户需确保 PHP 安装目录下的 ext 文件夹中存在 php_openssl.dll 文件,并且系统环境变量中包含了 PHP 的 DLL 依赖路径。
还需确认以下 DLL 是否存在于系统路径或 PHP 目录中:
若缺失,可从官方 PHP Windows 发行包中补全,或重新下载完整版 PHP 包替换。
在 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 服务器。
执行以下命令检查 OpenSSL 是否已加载:
php -m | grep openssl如果看到输出 openssl,再尝试运行 Composer 命令,错误应该消失。
基本上就这些。只要确保 PHP 正确启用了 OpenSSL 扩展,Composer 就能正常工作。不复杂但容易忽略配置细节。
以上就是composer提示“The openssl extension is required”错误的解决方案的详细内容,更多请关注php中文网其它相关文章!
每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号