Gateway类的使用

    Gateway类用于初始化Gateway进程。Gateway进程是暴露给客户端的让其连接的进程。所有客户端的请求都是由Gateway接收然后分发给BusinessWorker处理,同样BusinessWorker也会将要发给客户端的响应通过Gateway转发出去。

    Gateway类是基于基础的Worker开发的。可以给Gateway对象的onWorkerStart、onWorkerStop、onConnect、onClose设置回调函数,但是无法给设置onMessage回调。Gateway的onMessage行为固定为将客户端数据转发给BusinessWorker。

    初始化Gateway进程类似下面的代码

    其中参数各参数含义入下:

    protocol:

    为应用层协议,目前支持的协议有

    1、websocket协议

    2、

    3、Frame协议

    4、

    5、tcp,直接裸tcp,不推荐,见。

    :GatewayWorker不支持监听Http协议和ws协议。但是可以在业务中以客户端的形式通过http协议(比如curl)或者ws协议(配合AsyncTcpConnection)访问远程服务器。

    ip:

    1、如果写0.0.0.0代表监听本机所有网卡,也就是内网、外网、本机都可以访问到

    2、如果是127.0.0.1,代表只能本机通过127.0.0.1访问,外网和内网都访问不到

    3、如果是内网ip例如:192.168.10.11,代表只能通过192.168.10.11访问,也就是只能内网访问,本机127.0.0.1也访问不了(如果监听的ip不属于本机则会报错)

    port:

    端口不能大于65535,请确认端口没有被其它程序占用,否则启动会报错。如果端口小于1024,需要root权限运行GatewayWorker才能有权限监听,否则报错没有权限。

    Gateway类可以定制的内容

    1、 协议

    和Worker一样,在初始化Gateway对象时设置Gateway的协议,例如下面设置Gateway的通讯协议为websocket

    1. $gateway = new Gateway("websocket://0.0.0.0:8585");

    2、name

    和Worker一样,可以设置Gateway进程的名称,方便status命令中查看统计

    3、count

    和Worker一样,可以设置Gateway进程的数量,以便充分利用多cpu资源

    4、lanIp

    lanIp是Gateway所在服务器的内网IP,默认填写127.0.0.1即可。多服务器分布式部署的时候需要填写真实的内网ip,不能填写127.0.0.1。

    5、startPort

    当本机有多个Gateway/BusinessWorker项目时,需要把每个项目的startPort设置成不同的段

    6、registerAddress,注册服务地址,只写格式类似于 ‘127.0.0.1:1236’

    7、心跳设置,具体说明见心跳一节

    8、onWorkerStart

    和Worker一样,可以设置Gateway进程启动后的回调函数,一般在这个回调里面初始化一些全局数据

    9、onWorkerStop

    和Worker一样,可以设置Gateway进程关闭的回调函数,一般在这个回调里面做数据清理或者保存数据工作

    10、onConnect(比较少用到,开发者一般不用关注)

    和Worker一样,可以设置onConnect回调,当有客户端连接上来时触发。与Events::onConnect的区别是Events::onConnect运行在BusinessWorker进程上。Gateway::onConnect是运行在Gateway进程上,无法使用\GatewayWorker\Lib\Gateway类提供的接口

    11、onClose(比较少用到,开发者一般不用关注)

    和Worker一样,可以设置onClose回调,当有客户端连接关闭时触发。同样与Events::onClose的区别是Gateway::onClose是运行在Gateway进程上,无法使用\GatewayWorker\Lib\Gateway类提供的接口