PHP编译未启用OpenSSL会导致HTTPS请求失败，根本原因是协议层缺失而非证书问题；需在configure时加--with-openssl并重新编译，php.ini中启用extension=openssl对静态链接无效。
PHP 编译时没启用 OpenSSL，curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true) 会失败
OpenSSL 不是 PHP 默认必启扩展，尤其在自编译或某些精简 Docker 镜像里常被遗漏。最直接的表现是：file_get_contents("https://...") 报错 Unable to find the wrapper "https" - did you forget to enable it when you configured PHP?，或者 cURL 请求 HTTPS 地址时提示 Unknown SSL protocol error 或直接拒绝连接。
根本原因是 PHP 缺少 OpenSSL 扩展支持，而非证书路径或 CA 包问题 —— 连协议层都未加载，验证环节根本不会触发。
- 确认系统已安装 OpenSSL 开发库：
pkg-config --modversion openssl（Linux/macOS）；Windows 编译需有libssl.lib和头文件 - configure 时必须显式加
--with-openssl（路径可选，如--with-openssl=/usr/local/ssl） - 若用
--enable-opcache等其他选项，--with-openssl必须一同出现，顺序无关但缺一不可 - 编译后检查：
php -m | grep openssl
应输出openssl；php -r "print_r(openssl_get_cipher_methods());"
不报错即生效
php.ini 里启用 extension=openssl 没用，除非模块已编译进 PHP
很多人看到 extension=openssl 在 php.ini 里被注释，就取消注释并重启 Web 服务 —— 这只对「以动态扩展形式存在」的 openssl.so（Linux）或 php_openssl.dll（Windows）有效。而大多数源码编译默认是「静态链接」，即 OpenSSL 功能直接打进 php 可执行文件，此时扩展配置项无效，强行写入反而可能引发警告。
- 先运行
php -i | grep "Configure Command"
，查看 configure 参数是否含--with-openssl - 若含，则无需改
php.ini，也不应放extension=openssl - 若不含，且你坚持用动态扩展，需重新编译 PHP 并加
--with-openssl=shared，再确保openssl.so在extension_dir下 - 常见误操作：Docker 中
docker-php-ext-install openssl实际无效（该命令不处理 OpenSSL，它只装pdo、mbstring等纯 PHP 扩展）
OpenSSL 版本太低导致 TLS 1.2+ 握手失败
PHP 自身不实现 TLS，完全依赖底层 OpenSSL 库。若系统 OpenSSL 版本 ≤ 1.0.1f（如 CentOS 6 默认），则默认不支持 TLS 1.2，访问现代 HTTPS 站点（如 api.github.com）会直接失败，错误类似：cURL error 35: Unknown SSL protocol error 或 SSL connect error。
立即学习“PHP免费学习笔记（深入）”；
- 检查版本：
openssl version
；PHP 中可用php -r "print OPENSSL_VERSION_TEXT;"
- 升级 OpenSSL 到 1.0.2u / 1.1.1x 或更高（注意：1.1.0 已 EOL，1.1.1 是长期支持版）
- 升级后必须**重新编译 PHP**，仅替换系统库文件无效 —— PHP 在 configure 阶段已硬编码符号引用和结构体偏移
- 部分云主机或容器环境（如 Alpine）需用
apk add openssl1.1-dev并指定--with-openssl=/usr/include/openssl1.1
PHP-FPM 或 CLI 的 OpenSSL 行为不一致？检查 php.ini 加载路径不同
Web 请求走 PHP-FPM，命令行走 CLI，两者可能加载不同 php.ini 文件，导致一个能跑 HTTPS、另一个报错。典型现象是 curl https://httpbin.org 命令行成功，但网页中 file_get_contents() 失败。
- CLI 查看配置：
php --ini
- FPM 查看配置：在 Web 脚本中写 ，搜索 “Loaded Configuration File”
- 确认两者都加载了同一份
php.ini，或至少都启用了 OpenSSL（静态链接则此项无关） - 更隐蔽的问题：FPM pool 配置中设置了
php_admin_value[openssl.cafile]，而 CLI 未设，导致证书验证行为差异
OpenSSL 支持不是“开关式配置”，它横跨系统库、编译参数、运行时加载三个层面。最容易卡住的地方，是以为改了 php.ini 就万事大吉，却忽略了 configure 阶段是否真正链接了 OpenSSL。
