PHP开启OpenSSL支持方法

PHP无法发起HTTPS请求的根本原因常被误认为是证书配置问题，实则是编译时未启用OpenSSL支持——这一底层协议层缺失导致`file_get_contents("https://...")`报“Unable to find the wrapper 'https'”、cURL出现“Unknown SSL protocol error”等典型错误；正确解法是在源码编译阶段显式添加`--with-openssl`参数并重新编译（动态扩展需额外指定`--with-openssl=shared`），而单纯在php.ini中启用`extension=openssl`对静态链接无效，Docker中`docker-php-ext-install openssl`更是完全无效操作；同时需确保系统OpenSSL库版本≥1.0.2u或1.1.1x，且升级后必须重编PHP——因为TLS能力由编译时绑定的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。

• 检查版本：

  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。

今天关于《PHP开启OpenSSL支持方法》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！