0

0

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

看不見的法師

看不見的法師

发布时间:2026-01-17 11:53:15

|

520人浏览过

|

来源于php中文网

原创

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=opensslphp.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.soextension_dir
  • 常见误操作:Docker 中 docker-php-ext-install openssl 实际无效(该命令不处理 OpenSSL,它只装 pdombstring 等纯 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 errorSSL connect error

墨刀AIPPT
墨刀AIPPT

排版/配图/美化一键优化,3分钟产出专业级PPT

下载

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

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

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
curl_exec
curl_exec

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

454

2023.06.14

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

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

183

2023.10.30

scripterror怎么解决
scripterror怎么解决

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

451

2023.10.18

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

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

373

2023.10.25

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

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

1645

2023.10.23

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

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

449

2025.06.09

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

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

201

2025.07.04

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

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

3616

2026.01.21

JavaScript浏览器渲染机制与前端性能优化实践
JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开,系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理,以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例,帮助开发者理解浏览器底层工作原理,并掌握提升网页加载速度与交互体验的实用技巧。

1

2026.03.06

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 13万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 11.3万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 1.0万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号