- 1.1 序言
- 1.2 原理
- 1.3 开发必读
- 1.4 入门指引
- 1.4.1 特性
- 1.4.2 简单的开发示例
- 1.5 安装
- 1.5.1 环境要求
- 1.5.2 下载安装
- 1.5.3 启动停止
- 1.6 开发流程
- 1.6.1 开发前必读
- 1.6.2 目录结构
- 1.6.3 开发规范
- 1.6.4 基本流程
- 1.7 通讯协议
- 1.7.1 通讯协议作用
- 1.7.2 定制通讯协议
- 1.7.3 一些例子
- 1.8 Worker类
- 1.8.1 构造函数
- 1.8.2 属性
- 1.8.2.1 id
- 1.8.2.2 count
- 1.8.2.3 name
- 1.8.2.4 protocol
- 1.8.2.5 transport
- 1.8.2.6 reusePort
- 1.8.2.7 connections
- 1.8.2.8 stdoutFile
- 1.8.2.9 pidFile
- 1.8.2.10 logFile
- 1.8.2.11 user
- 1.8.2.12 reloadable
- 1.8.2.13 daemonize
- 1.8.2.14 globalEvent
- 1.8.3 回调属性
- 1.8.3.1 onWorkerStart
- 1.8.3.2 onWorkerReload
- 1.8.3.3 onConnect
- 1.8.3.4 onMessage
- 1.8.3.5 onClose
- 1.8.3.6 onBufferFull
- 1.8.3.7 onBufferDrain
- 1.8.3.8 onError
- 1.8.4 接口
- 1.8.4.1 runAll
- 1.8.4.2 stopAll
- 1.8.4.3 listen
- 1.9 TcpConnection类
- 1.9.1 属性
- 1.9.1.1 id
- 1.9.1.2 protocol
- 1.9.1.3 worker
- 1.9.1.4 maxSendBufferSize
- 1.9.1.5 defaultMaxSendBufferSize
- 1.9.1.6 defaultMaxPackageSize
- 1.9.2 回调属性
- 1.9.2.1 onMessage
- 1.9.2.2 onClose
- 1.9.2.3 onBufferFull
- 1.9.2.4 onBufferDrain
- 1.9.2.5 onError
- 1.9.3 接口
- 1.9.3.1 send
- 1.9.3.2 getRemoteIp
- 1.9.3.3 getRemotePort
- 1.9.3.4 close
- 1.9.3.5 destroy
- 1.9.3.6 pauseRecv
- 1.9.3.7 resumeRecv
- 1.9.3.8 pipe
- 1.10 AsyncTcpConnection类
- 1.10.1 __construct
- 1.10.2 connect
- 1.10.3 reconnect
- 1.10.4 transport
- 1.11 AsyncUdpConnection类
- 1.11.1 __construct
- 1.11.2 connect
- 1.11.3 send
- 1.11.4 close
- 1.12 Timer定时器类
- 1.12.1 add
- 1.12.2 del
- 1.12.3 定时器注意事项
- 1.14 调试
- 1.14.1 基本调试
- 1.14.2 status命令查看运行状态
- 1.14.3 调试busy进程
- 1.14.4 网络抓包
- 1.14.5 跟踪系统调用
- 1.15 常用组件
- 1.15.1 GlobalData数据共享组件
- 1.15.1.1 GlobalDataServer
- 1.15.1.2 GlobalDataClient
- 1.15.1.2.1 add
- 1.15.1.2.2 cas
- 1.15.1.2.3 increment
- 1.15.2 Channel分布式通讯组件
- 1.15.2.1 ChannelServer
- 1.15.2.2 channelClient
- 1.15.2.2.1 connect
- 1.15.2.2.2 on
- 1.15.2.2.3 publish
- 1.15.2.2.4 unsubsribe
- 1.15.2.3 例子-集群推送
- 1.15.2.4 例子-分组发送
- 1.15.3 FileMonitor文件监控组件
- 1.15.4 MySQL组件
- 1.15.4.1 workerman/mysql
- 1.15.4.2 react/mysql(异步)
- 1.15.4.3 其它数据库类
- 1.15.5 redis组件
- 1.15.5.1 react/redis
- 1.15.6.1 workerman/http-client
- 1.15.6.2 react/http-client
- 1.15.7 异步消息队列组件
- 1.15.7.1 react/zmq
- 1.15.7.2 react/stomp
- 1.15.8 异步MQTT组件
- 1.15.8.1 workemran/mqtt
- 1.15.9.1 react/dns
- 1.15.10 memcache
- 1.16 常见问题
- 1.16.1 心跳
- 1.16.2 客户端连接失败原因
- 1.16.3 是否支持多线程
- 1.16.4 与其它框架整合
- 1.16.5 运行多个workerman
- 1.16.6 支持哪些协议
- 1.16.7 如何设置进程数
- 1.16.8 查看客户端连接数
- 1.16.9 对象和资源的持久化
- 1.16.10 例子无法工作
- 1.16.11 启动失败
- 1.16.12 停止失败
- 1.16.13 支持多少并发
- 1.16.14 更改代码不生效
- 1.16.15 向指定客户端发送数据
- 1.16.16 如何主动推送消息
- 1.16.17 在其它项目中推送
- 1.16.18 如何实现异步任务
- 1.16.19 status里send_fail的原因
- 1.16.20 Windows下开发Linux下部署
- 1.16.21 是否支持socket.io
- 1.16.22 终端关闭导致workerman关闭
- 1.16.23 与nginx apache的关系
- 1.16.24 禁用函数检查
- 1.16.25 平滑重启原理
- 1.16.26 为Flash开843端口
- 1.16.27 如何广播数据
- 1.16.28 如何建立udp服务
- 1.16.29 监听ipv6
- 1.16.30 关闭未认证的连接
- 1.16.31 传输加密-ssl/tls
- 1.16.32 创建wss服务
- 1.16.33 创建https服务
- 1.16.34 workerman作为客户端
- 1.16.35 作为ws/wss客户端
- 1.16.36 微信小程序
- 1.16.37 PHP的几种回调写法
- 1.16.38 透过代理获取客户端真实ip
- 1.16.39 开机启动
- 1.16.40 接收和发送16进制数据
- 1.16.41 接收一定请求后重启
- 1.16.42 win下初始化多个worker
- 1.17.1 优化Linux内核
- 1.17.2 压力测试
- 1.17.3 安装扩展
- 1.17.4 websocket协议
- 1.17.5 ws协议
- 1.17.6 text协议
- 1.17.7 frame协议
- 1.17.8 不支持的函数/特性
1.3 开发必读
1、windows环境限制
windows系统下workerman单个进程仅支持200+个连接。 windows系统下无法使用count参数设置多进程。 windows系统下无法使用status、stop、reload、restart等命令。 windows系统下无法守护进程,cmd窗口关掉后服务即停止。 windows系统下无法在一个文件中初始化多个监听。 linux系统无上面的限制,建议正式环境用linux系统,开发环境可以选择用windows系统。
2、workerman不依赖apache或者nginx
workerman本身已经是一个类似apache/nginx的容器,只要 workerman就可以运行。
3、workerman是命令行启动的
启动方式类似apache使用命令启动(一般网页空间无法使用workerman)。启动界面类似下面
4、长连接必须加心跳
长连接必须加心跳,长连接必须加心跳,长连接必须加心跳,重要的话说三遍。 长连接长时间不通讯会被路由节点清理导致连接关闭。 workerman心跳说明、 gatewayWorker心跳说明
5、客户端和服务端协议一定要对应才能通讯
这个是开发者非常常见的问题。例如客户端是用websocket协议,服务端必须也是websocket协议(服务端new Worker('websocket://0.0.0.0...')
)才能连得上,才能通讯。 不要尝试在浏览器地址栏访问websocket协议端口,不要尝试用webscoket协议访问裸tcp协议端口,协议一定要对应。
这里的原理类似如果你要和英国人交流,那么要使用英语。如果要和日本人交流,那么要使用日语。这里的语言就类似与通许协议,双方(客户端和服务端)必须使用相同的语言才能交流,否则无法通讯。
6、连接失败可能的原因
刚开始使用workerman时很常见的一个问题是客户端连接服务端失败。 原因一般如下: 1、服务器防火墙(包括云服务器安全组)阻止了连接 (50%几率是这个) 2、客户端和服务端使用的协议不一致 (30%几率) 3、ip或者端口写错了 (15%的几率) 4、服务端没启动
7、不要使用exit die sleep语句
业务执行exit die语句会导致进程退出,并显示WORKER EXIT UNEXPECTED错误。当然,进程退出了会立刻重启一个新的进程继续服务。如果需要返回,可以调用return。sleep语句会让进程睡眠,睡眠过程中不会执行任何业务,框架也会停止运行,会导致该进程的所有客户端请求都无法处理。
8、不要使用pcntl_fork函数
pcntl_fork
用来动态创建新的进程,如果在业务代码中使用pcntl_fork
,它可能会产生无法回收孤儿进程,导致业务出现异常。业务中pcntl_fork
还会影响连接、消息、连接关闭、定时器等事件的处理,导致不可预知的异常。
9、业务代码里不要有死循环
业务代码里不要有死循环,否则会导致控制权无法交还给workerman框架,导致无法接收处理其它客户端消息。
10、改代码要重启
workerman是常驻内存的框架,改代码要重启workerman才能看到新代码的效果。
11、长连接应用建议用GatewayWorker框架
很多开发者使用workerman是要开发长连接应用,例如即时通讯、物联网等,长连接应用建议直接使用GatewayWorker框架,它专门在workerman的基础上再次封装,做起长连接应用后台更简单、更易用。
12、支持更高并发 如果业务并发连接数超过1000同时在线,请务必优化linux内核,并安装event扩展或者libevent扩展。
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论