Composer报错OpenSSL扩展未启用，需检查CLI模式php.ini中extension=openssl是否启用，并确认PHP已正确加载该扩展。
Composer 报错 OpenSSL extension is required 或下载包时提示 file could not be downloaded: SSL operation failed，说明 PHP 环境缺少 OpenSSL 支持，或虽已编译但未启用 —— 这不是 Composer 自身问题，而是 PHP 运行时缺失关键扩展。
确认 openssl 扩展是否真的加载
运行 php -m | grep openssl（Linux/macOS）或 php -m（Windows，人工查找），看输出中是否有 openssl。注意：仅安装了 OpenSSL 库 ≠ PHP 加载了 openssl 扩展；也别只查 phpinfo() 页面 —— CLI 和 Web 使用的 php.ini 可能不同，Composer 走的是 CLI 模式，必须检查 php -i | grep "Loaded Configuration File" 对应的配置文件。
- 如果没输出
openssl，说明扩展未启用 - 如果看到
openssl但 Composer 仍报错，大概率是 CLI 的php.ini中extension=openssl被注释或路径错误 - 某些 Docker 镜像（如
php:alpine）默认不带openssl扩展，需手动docker-php-ext-install openssl
Linux/macOS 下启用 openssl 扩展（常见场景）
多数 Linux 发行版 PHP 包会把 openssl.so 编译好，但默认不启用。找到 CLI 模式生效的 php.ini（用 php --ini 查），编辑它：
sudo nano $(php --ini | grep "Loaded Configuration File" | cut -d' ' -f4)
确保以下两行未被注释（即前面没有分号 ;）：
;extension=openssl ;extension=sockets
改成：
extension=openssl extension=sockets
保存后执行 php -m | grep openssl 验证。若提示 Unable to load dynamic library，说明路径不对 —— 此时应写绝对路径，例如：
extension=/usr/lib/php/20220829/openssl.so
路径可通过 find /usr -name "openssl.so" 2>/dev/null 查找。
Windows 下启用 openssl 扩展（WAMP/XAMPP/手动安装）
打开 CLI 对应的 php.ini（不是 Apache 或 Nginx 的那个），通常位于 php\php-xx.x.x\php.ini。取消注释这两行：
; extension=php_openssl.dll ; extension=php_sockets.dll
改为：
extension=php_openssl.dll extension=php_sockets.dll
注意：php_openssl.dll 必须存在于 php/ext/ 目录下；若不存在，说明 PHP 编译时未开启 OpenSSL 支持（常见于精简版二进制包），需换用官方线程安全（TS）+ OpenSSL 内置版本，或改用 XAMPP/WAMP 等集成环境。
改完重启终端，再运行 php -v —— 如果仍报 PHP Startup: Unable to load dynamic library 'php_openssl.dll'，说明 DLL 依赖缺失，需将 php\ 目录加入系统 PATH，或把 libeay32.dll 和 ssleay32.dll（旧版）或 libcrypto-1_1-x64.dll、libssl-1_1-x64.dll（新版）复制到 Windows\System32（64位）或 Windows\SysWOW64（32位）。
临时绕过 HTTPS（仅限调试，不推荐生产）
如果实在无法启用 OpenSSL（极少见），可强制 Composer 使用 HTTP 协议拉取包（有安全与可靠性风险）：
composer config -g repo.packagist.org.url http://packagist.org
但这会导致：
- 所有包元数据无签名校验，可能被中间人篡改
- 部分私有仓库或新版本 Packagist 不再支持 HTTP
- 某些包含 HTTPS-only 资源（如 GitHub tarball）仍会失败
真正稳定的做法永远是修复 OpenSSL 扩展，而不是降级协议。Windows 用户尤其要注意：从 PHP 8.2 起，官方 Windows 构建已强制要求 OpenSSL 1.1.1+，禁用该扩展将直接导致 curl_init() 失败 —— 这类底层断裂比 Composer 报错更隐蔽，也更难排查。
