讲师中心 微信公众号
AI工具推荐 视频效率加速

Workerman怎样配置SSL实现安全通信

胖强小哥_2800

胖强小哥_2800

发布时间:2026-06-29 18:51:42

|

825人浏览过

|

来源于php中文网

原创

必须显式传入SSL上下文参数并确保证书路径绝对、私钥无密码、verify_peer设为false,否则监听443端口也会触发ERR_SSL_PROTOCOL_ERROR;需启用openssl扩展、Workerman≥3.3.7,证书须为PEM格式且fullchain.pem含私钥→域名证书→中间证书顺序。

workerman怎样配置ssl实现安全通信

Workerman配置SSL实现安全通信,必须显式传入SSL上下文参数并确保证书路径绝对、私钥无密码、verify_peer设为false,否则即使监听443端口也会触发ERR_SSL_PROTOCOL_ERROR,浏览器直接断连。

确认前提条件

检查PHP是否启用openssl扩展:运行php -m | grep openssl,无输出则需启用;确认Workerman版本≥3.3.7,低于此版本不支持原生SSL;证书文件(.pem或.crt + .key)必须已准备好,且为PEM格式。

【私钥不能带密码】,否则Workerman启动时静默卡死无报错。可用openssl rsa -in server.key -out server-no-pass.key去密。

生成自签名证书(开发测试用)

执行以下三条命令生成server.key和server.crt:

openssl genrsa -out server.key 2048

openssl req -new -key server.key -out server.csr(Common Name填localhost或测试域名)

openssl x509 -req -days 365 -in server.csr -signkey server.key -out server.crt

注意:server.crt只含证书,不含私钥;生产环境请用Let's Encrypt等CA签发的fullchain.pem(含域名证书+中间证书),且务必把私钥合并进同一PEM文件或单独提供local_pk。

配置HTTPS服务

方法一:使用WebServer类(推荐,语义清晰)

第一步:引入Autoloader并实例化WebServer,协议写ssl://,端口建议443

第二步:构造时直接传入ssl_context数组,键名必须是ssl_context,不是context或ssl

第三步:指定local_cert为绝对路径的全链证书文件(含私钥+证书+中间证书),local_pk可省略——若私钥已包含在local_cert中;否则必须同时提供且路径为绝对路径

【verify_peer => false是硬性要求】,设为true会导致TLS握手失败,客户端连接立即重置。

示例代码:

$web = new WebServer('ssl://0.0.0.0:443', [

SSL Certificate Monitor
SSL Certificate Monitor

检查一个或多个域名的 SSL/TLS 证书到期时间、颁发者、协议及 SAN 信息,用于应要求检查证书、监控到期或验证 HTTPS 等场景。

下载

  'ssl_context' => [

    'local_cert' => '/var/www/ssl/fullchain.pem',

    'local_pk'  => '/var/www/ssl/privkey.pem',

    'verify_peer' => false

  ]

]);

配置WSS服务(WebSocket over SSL)

方法一:Worker构造时传context + transport='ssl'

创建Worker实例时协议写websocket://0.0.0.0:443,同时传入context数组,其中ssl子数组与HTTPS配置一致

必须手动设置$worker->transport = 'ssl',否则仍是ws协议

方法二:直接用ssl://协议前缀(更简洁)

将协议改为ssl://0.0.0.0:443,再通过$worker->onMessage处理WebSocket帧即可,无需额外设transport

注意:微信小程序等客户端必须用wss://域名访问,且证书域名需匹配,localhost不可用自签名证书直连。

验证与排错

启动后执行php start.php start,无报错不代表成功。用curl验证:curl -I https://your-domain.com,返回200 OK且Header含HTTP/2或HTTP/1.1即通

若浏览器报ERR_CONNECTION_RESET,立刻检查:① local_cert路径是否绝对;② PHP进程用户(如www-data)对证书文件是否有读权限(ls -l看);③ 私钥是否被加密;④ fullchain.pem里私钥是否在最开头、顺序是否为私钥→域名证书→中间证书

用openssl x509 -in fullchain.pem -text -noout | head -20确认证书内容可读;用openssl rsa -in privkey.pem -check -noout验证私钥有效性。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

Lovart
Lovart Hot

一款面向视觉设计创作的AI设计平台,可通过智能体和画布工作流辅助制作海报、Logo、网页、PPT及其他视觉内容。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

相关专题

更多
SSL检测工具介绍
SSL检测工具介绍

SSL检测工具有SSL Labs、SSL Check、SSL Server Test、SSLMate、SSL/TLS Analyzer等。详细介绍:1、SSL Labs是一个由Qualys提供的在线SSL检测工具,可以评估服务器证书的部署情况、加密套件、协议支持等方面的安全性,它提供了一个详细的报告,包括证书的颁发者、有效期、安全性配置等;2、SSL Check等等。

770

2023.10.20

Workerman安装配置教程
Workerman安装配置教程

Workerman安装配置教程专题提供Workerman安装配置、WebSocket开发、TCP通信、异步编程、高并发服务搭建与PHP实时通信开发教程。

186

2026.05.20

Workerman实时通信与长连接开发教程
Workerman实时通信与长连接开发教程

WWorkerman实时通信与长连接开发教程聚合实时通信、聊天室、长连接、消息推送、AI流式输出等Workerman高并发开发内容。

202

2026.05.20

Workerman异步通信与TCP服务器开发
Workerman异步通信与TCP服务器开发

Workerman异步通信与TCP服务器开发专题整理Workerman异步通信、TCP服务、HTTP服务、WebSocket开发与高并发PHP服务器教程。

207

2026.05.20

OpenJDK JVM参数怎么调优
OpenJDK JVM参数怎么调优

Java应用运行缓慢,如何调整JVM参数?本专题介绍OpenJDK JVM性能调优的基本流程,涵盖性能指标确认、运行数据采集、内存配置和垃圾回收分析,帮助你先定位瓶颈,再通过对照测试验证效果,避免直接套用参数而影响应用稳定性。

60

2026.10.16

OpenJDK怎么配置Java开发环境
OpenJDK怎么配置Java开发环境

怎样用OpenJDK搭建开发环境?本专题介绍版本选择、下载安装、环境变量配置和编译运行验证,帮助你理清JDK的作用及基本配置流程,并通过简单程序检查环境是否可用,为后续项目开发做好准备。

40

2026.10.16

OpenJDK怎么部署Java应用
OpenJDK怎么部署Java应用

Java项目开发完成后,怎样部署到目标环境并正常运行?本专题介绍OpenJDK应用部署流程,涵盖运行环境准备、版本兼容检查、应用打包、启动参数配置和日志查看,帮助你理清部署前后的操作顺序,减少环境差异造成的运行问题。

40

2026.10.16

Revel框架模板渲染与表单验证
Revel框架模板渲染与表单验证

本专题围绕Revel框架视图层开发,介绍模板语法、变量输出、布局复用、表单提交、参数绑定与验证规则,帮助开发者完成安全规范的页面交互。

20

2026.10.16

Revel框架MVC路由与控制器
Revel框架MVC路由与控制器

本专题聚焦Revel框架MVC核心机制,讲解路由定义、控制器Action、参数绑定、请求响应和反向路由,并结合常见场景梳理接口请求处理流程。

20

2026.10.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Webman中文手册
Webman中文手册

共0课时 | 0人学习

Workerman官方手册
Workerman官方手册

共0课时 | 0人学习

ThinkPHP5.1完全开发手册
ThinkPHP5.1完全开发手册

共0课时 | 0人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn