发布一个轻量级的PHP实现的WEBSOKCET引擎-EZ_WS

利用零散的时间,用php这门语言写了个轻量级的WebSocket引擎-EZ_WS,期间也在这世界上最好的语言上踩过几个坑,不过坑踩过了,东西也出来了,现分享给大家;

GitHub网址:https://github.com/GavinLiu168/ez_ws


以下是说明文档

EZ_WS是easy-websocket的意思,旨在提供一个websocket的php版本引擎,让php开发人员更加快速的使用websocket。

EZ_WS使用了多进程模式以增大服务的并发能力,但windows环境下不支持php的多进程控制模块,因此windows环境下EZ_WS就会退化成单进程模式。

以下介绍下框架的基本用法:

1.框架概念

(1)WsServer类:管理整个服务的服务类,提供了面向用户的api;

(2)WsWorker类:主要的工作类,主要用户socket的管理;

(3)WebSocket类:用户描述websocket的类,是在socket上封装出来的类,主要用于处理与websocket协议相关的逻辑;

(4)WsFrame类:用于描述websocket帧的各种参数的类,也提供面向用户的生成查询frame的类;

(5)IPCFrame类:用户进程间通讯的类,主要规范了进程间通讯的协议;

(6)Task类:抽象类,用户继承实现该类则可使用异步任务;

(7)socket资源id($resId),框架中每个socket都用框架提供的resId来统一管理;

2.引入框架

 <?php
    require_once('../../ez_ws/ez_ws.php');
    use Lib\WsServer;
    use Lib\WsFrame;

3.WsServer类使用例子

<?php

#设置时区
date_default_timezone_set("PRC");

#新建server类
$server = new WsServer("0.0.0.0",10086);

#设置worker进程数目为5,默认为10
$server->setWorkerNum(5);

#注册open函数(hanshake后触发)
$server->on("open",function(WsServer $server,$resId){
    #ping操作
    $wf = WsFrame::pingFrame();
    $server->push($resId,$wf);
});

#注册close函数(closed事件触发)
$server->on("close",function(WsServer $server,$resId,$status_Code){
    //----to--do---
});

#注册pong函数(pong事件触发)
$server->on("pong",function(WsServer $server,$resId){
    //----to--do---
});

#注册message函数(收到信息时触发)
$server->on("message",function(WsServer $server,$resId,WsFrame $wf){
    #广播消息
    $wf->mask = 0;
    $server->broadcast($wf->encode());
});

#开启服务器
$server->start();

4.WsFrame类api

<?php
    $wf = new WsFrame();

    //设置是否结束帧以及是否开启掩码(注意,服务端无需开启掩码发送),可用链式操作
    $wf->finOn()->finOff()->maskOn()->maskOff();

    //设置操作码,不设置则默认为OPCODE_BINARY_FRAME,可链式操作
    /*OPCODE_CONTINUE=>"frame continuation",
    *OPCODE_TEXT_FRAME=>"text frame",
    *OPCODE_BINARY_FRAME=>"binary  frame",
    *OPCODE_CLOSE_FRAME=>"connection close",
    *OPCODE_PING=>"ping",
    *OPCODE_PONG=>"pong",
    */
    $wf->setOpcode(WsFrame::OPCODE_TEXT_FRAME);

    //设置body内容,可用链式操作
    $wf->setBody("hello world");

    //将wsframe编码,发送前必须encode
    $wf->encode();

    //立即生成pingframe
    $wf = WsFrame::pingFrame();

    //立即生成pongframe
    $wf = WsFrame::pongFrame();

    //立即生成closeFrame,status为状态码,缺省下为1001正常退出码
    $wf = WsFrame::closeFrame($status);

    //立即生成endframe,$opcode可不填,可用于大文件的分块传输
    $wf = WsFrame::endFrame($opcode);

    //获取帧的信息,以数组形式返回
    $wf->info();

    //充值数据帧
    $wf->reset();

5.异步任务(windows环境下将退化为同步任务)

<?php
    require_once('../../ez_ws/ez_ws.php');
    use Lib\WsFrame;
    use Lib\Task;
    use Lib\WsServer;

    class MyTask extends Task{


        //必须继承实现的方法
        protected function run(){
            echo "hello mytask";
        }

    }
已标记关键词 清除标记
©️2020 CSDN 皮肤主题: 编程工作室 设计师:CSDN官方博客 返回首页