- 推送采用websocket长连接，采用接口形式获取，客户端缓存5-10分钟。
- 断线重连最多三次，时间间隔为60s、120s、180s，是上次交互的时间 与检测时候的时间相差180s，就被被踢出。
- 客户端每180s发送一次心跳包检测连接是否可用，如果接收到服务器的推送消息，则从当前开始计算180s，减少无效的心跳检测。 如果心跳包在30s内无响应，则再发送一个心跳包，等待30s，无反应，判定连接失效。
- 客户端新连接成功，如果用户登录，需要发送登录ukey(web)或token(app)给服务器进行登录，未登录成功间隔30s重试一次，一经登录，除非断开或者调用退出登录，否则不会掉线。
- 连接支持ws和wss，建议使用wss安全连接。
- 登录使用ukey(web端) / token(App端) 去请求gzcp主站的验证接口。
- 请求数据除了body字段是可以为空的，服务端会做校验和检测，具体以wiki例子为主。
- ws在线测试工具：http://www.easyswoole.com/wstool.html
开发环境：
swoole version 4.4.23
php version 7.2.10
测试服 ：host
外网：spush.test.gongzicp.com
内网：http://swoole-msg:18081
生产环境：host:
内网：swoole.push.com
外网：spush.gongzicp.com
安装swoole,git地址：https://github.com/swoole/swoole-src/tree/v4.4.x
git clone https://github.com/swoole/swoole-src.git
cd swoole-src && \
phpize && \
./configure \
--enable-openssl \
--enable-http2 && \
make && sudo make install
swoole-push分支
git clone git@59.110.162.133:/home/git/swoole-push.git
gzcp分支 swoole_push_0113
/gzcp/library/GoPush/Base.php
/gzcp/library/GoPush/Push.php
1.1 安装需要的扩展
composer install
2.配置环境变量 ，路径/bootstrap.php
//环境变量开关 0本地，1测试 2线上
define('PUSHENV', 0);3.设置允许最大链接数 MaxLinkNumber , 路径：swoole-push/App/SystemConf.php,修改之后执行热重启。
备注：swoole 现在不支持主进程热重启
4.配置文件路径
/swoole-push/App/Conf/Test/ 测试服配置目录：
测试服mysql：/swoole-push/App/Conf/Test/db.php
测试服redis：/swoole-push/App/Conf/Test/redis.php
/swoole-push/App/Conf/Test/ 正式服配置目录：
正式服mysql：/swoole-push/App/Conf/Online/db.php
正式服redis：/swoole-push/App/Conf/Online/redis.php
1启动/停止 服务
//-d 守护进程的方式启动服务
php easyswoole server start -mode=websocket -d
//停止服务
php easyswoole server stop -mode=websocket
//强制停止服务
php easyswoole server stop -force -mode=websocket
//热重启
php easyswoole server reload -mode=websocket2.进程管理：
//显示所有进程,以Mb方式显示
php easyswoole process show -d -mode=websocket
//杀死指定进程
php easyswoole process kill --pid=PID -mode=websocket
//杀死指定进程组(GROUP)
php easyswoole process kill --group=GROUP_NAME -mode=websocket
//杀死所有进程
php easyswoole process killAll -mode=websocket
//强制杀死进程,需要带上 -f 参数
php easyswoole process kill --pid=PID -f -mode=websocket3.Crontab 命令
可执行 php easyswoole crontab -h 来查看具体操作。
//查看所有注册的Crontab
php easyswoole crontab show -mode=websocket
//停止指定的Crontab
php easyswoole crontab stop --name=TASK_NAME -mode=websocket
//恢复指定的Crontab
php easyswoole crontab resume --name=TASK_NAME -mode=websocket
//立即跑一次指定的Crontab
php easyswoole crontab run --name=TASK_NAME -mode=websocket
4.Task管理
//查看 Task 进程状态
php easyswoole task status -mode=websocket
upstream swoole-push {
# 将负载均衡模式设置为IP hash
ip_hash;
server 127.0.0.1:9501;
}
server {
listen 80;
server_name swoole.push.com;
location / {
# websocket的header
proxy_http_version 1.1;
# 升级http1.1到websocket协议
proxy_set_header Upgrade websocket;
proxy_set_header Connection "Upgrade";
# 将客户端host及ip信息转发到对应节点
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header Host $http_host;
# 客户端与服务端300s之内无交互，将自动断开连接。
proxy_read_timeout 300s ;
# 代理访问真实服务器
proxy_pass http://swoole-push;
}
}
Swoole-push和Gzcp有两处通信：
1.Token 验证接口, open.gzcp.com是对内接口
# 正式服Url
http://open.gzcp.com/push/user/getappuid
# 测试服Url
http://open.gzcp.com/login/pushMsgLogin
测试服参考数据：
| 字段名 | 说明 | 参考值 |
|---|---|---|
| timestamp | unix时间戳 | 1612322032 |
| loginkey | 客户端传递的Token | c1d0ab0add36c27e94efea2c65009691e3659705 |
| token | 服务端自定义Token | 98306025f1f216cdce7bcdb488c94753 |
?timestamp=1612322032
&loginkey=c1d0ab0add36c27e94efea2c65009691e3659705
&token=98306025f1f216cdce7bcdb488c94753
返回结果 ,没找到是0 :
{"code":200,"data":{"uid":176906}}
2.接收Gzcp的Push
文件路径：swoole-push/App/HttpController/Api/
接口Url：
#评论通知：/swoole-push/App/HttpController/Api/Comment.php
/api/comment/message
#系统消息通知 /swoole-push/App/HttpController/Api/Notice.php
/api/notice/systemMessage
#个人消息通知 /swoole-push/App/HttpController/Api/Notice.php
/api/notice/userMessage
3.Crontab
PushUserNoticeMsg */6 * * * * 个人通知，6分钟执行一次
PushSystemNoticeMsg * 0-23/3 * * * 全局通知，3小时执行一次
PushCommentMsg */6 * * * * 评论通知，6分钟执行一次