PHP怎么设置OpenSSL支持_PHP设置OpenSSL支持编译【协议】

轻浩姑娘_4281

轻浩姑娘_4281

2026-01-17

560人浏览

原创

PHP编译未启用OpenSSL会导致HTTPS请求失败,根本原因是协议层缺失而非证书问题;需在configure时加--with-openssl并重新编译,php.ini中启用extension=openssl对静态链接无效。

php怎么设置openssl支持_php设置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。

从 Git 仓库历史中彻底删除文件
从 Git 仓库历史中彻底删除文件

|Git删除了文件,但还会在Git 仓库历史中遗留。 - 想要从 Git 历史移除敏感信息(密码、密钥、token、私钥) - 想要删除意外提交的大文件 - 想要重写 Git 历史、移除特定文件的所有痕迹 - 提到 "force push"、"重写 commit 历史" - 需要从所有分支、所有 tag 中删除某个文件

下载
  • 检查版本:
    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 脚本中写
    <?php phpinfo(); ?>
    ,搜索 “Loaded Configuration File”
  • 确认两者都加载了同一份 php.ini,或至少都启用了 OpenSSL(静态链接则此项无关)
  • 更隐蔽的问题:FPM pool 配置中设置了 php_admin_value[openssl.cafile],而 CLI 未设,导致证书验证行为差异

OpenSSL 支持不是“开关式配置”,它横跨系统库、编译参数、运行时加载三个层面。最容易卡住的地方,是以为改了 php.ini 就万事大吉,却忽略了 configure 阶段是否真正链接了 OpenSSL。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关专题

更多
curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

2023.06.14

3743

6

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

2023.10.30

855

4

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

1009

5

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.25

3140

5

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4994

6

golang结构体相关大全
golang结构体相关大全

本专题整合了golang结构体相关大全,想了解更多内容,请阅读专题下面的文章。

2025.06.09

4994

18

golang结构体方法
golang结构体方法

本专题整合了golang结构体相关内容,请阅读专题下面的文章了解更多。

2025.07.04

5151

25

github中文官网入口 github中文版官网网页进入
github中文官网入口 github中文版官网网页进入

github中文官网入口https://docs.github.com/zh/get-started,GitHub 是一种基于云的平台,可在其中存储、共享并与他人一起编写代码。 通过将代码存储在GitHub 上的“存储库”中,你可以: “展示或共享”你的工作。 持续“跟踪和管理”对代码的更改。

2026.01.21

8645

27

GitHub官网入口版本汇总
GitHub官网入口版本汇总

本专题整合了GitHub入口版本地址汇总,阅读专题下面的文章了解更多详细内容。

2026.04.02

918

19

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习