onMessage
最后更新于：2022-04-02 06:34:21
# onMessage
[TOC]
当服务器收到来自客户端的数据帧时会回调此函数。
~~~
function onMessage(swoole_websocket_server $server, swoole_websocket_frame $frame)
~~~
* $frame 是swoole\_websocket\_frame对象，包含了客户端发来的数据帧信息
* onMessage回调必须被设置，未设置服务器将无法启动
* 客户端发送的`ping`帧不会触发`onMessage`，底层会自动回复`pong`包
## swoole\_websocket\_frame
共有4个属性，分别是
* $frame->fd，客户端的socket id，使用$server->push推送数据时需要用到
* $frame->data，数据内容，可以是文本内容也可以是二进制数据，可以通过opcode的值来判断
* $frame->opcode，WebSocket的OpCode类型，可以参考WebSocket协议标准文档
* $frame->finish， 表示数据帧是否完整，一个WebSocket请求可能会分成多个数据帧进行发送（底层已经实现了自动合并数据帧，现在不用担心接收到的数据帧不完整）
> $data 如果是文本类型，编码格式必然是UTF-8，这是WebSocket协议规定的
## OpCode与数据类型
* WEBSOCKET\_OPCODE\_TEXT = 0x1 ，文本数据
* WEBSOCKET\_OPCODE\_BINARY = 0x2 ，二进制数据
';