看到一些人,可能不太明白workerman与thinkphp5是怎么工作的,这里,我引用workerman官方的文章来解释一下,希望给你们一些参考。
## 与ThinkPHP等框架结合
使用GatewayWorker时开发者最关心的是如何与现有mvc框架(ThinkPHP Yii laravel等)整合,以下是官方推荐的整合方式。见示意图:
![](https://box.kancloud.cn/238d9394e0bbe3e03fe72cc73b3f61b6_439x352.png)
## 总体原则:
现有mvc框架项目与GatewayWorker独立部署互不干扰
所有的业务逻辑都由网站页面post/get到mvc框架中完成
GatewayWorker不接受客户端发来的数据,即GatewayWorker不处理任何业务逻辑,GatewayWorker仅仅当做一个单向的推送通道
仅当mvc框架需要向浏览器主动推送数据时才在mvc框架中调用Gateway的API(GatewayClient)完成推送
## 具体实现步骤
1、网站页面建立与GatewayWorker的websocket连接
2、GatewayWorker发现有页面发起连接时,将对应连接的client_id发给网站页面
3、网站页面收到client_id后触发一个ajax请求(假设是bind.php)将client_id发到mvc后端
4、mvc后端bind.php收到client_id后利用GatewayClient调用Gateway::bindUid($client_id, $uid)将client_id与当前uid(用户id或者客户端唯一标识)绑定。如果有群组、群发功能,也可以利用Gateway::joinGroup($client_id, $group_id)将client_id加入到对应分组
5、页面发起的所有请求都直接post/get到mvc框架统一处理,包括发送消息
6、mvc框架处理业务过程中需要向某个uid或者某个群组发送数据时,直接调用GatewayClient的接口Gateway::sendToUid Gateway::sendToGroup 等发送即可
## 示例代码
GatewayWorker中Events.php代码(只有个onConnect回调设置)
~~~
<?php
use \GatewayWorker\Lib\Gateway;
class Events
{
// 当有客户端连接时,将client_id返回,让mvc框架判断当前uid并执行绑定
public static function onConnect($client_id)
{
Gateway::sendToClient($client_id, json_encode(array(
'type' => 'init',
'client_id' => $client_id
)));
}
// GatewayWorker建议不做任何业务逻辑,onMessage留空即可
public static function onMessage($client_id, $message)
{
}
}
~~~
### 网站页面js片段
~~~
/**
* 与GatewayWorker建立websocket连接,域名和端口改为你实际的域名端口,
* 其中端口为Gateway端口,即start_gateway.php指定的端口。
* start_gateway.php 中需要指定websocket协议,像这样
* $gateway = new Gateway(websocket://0.0.0.0:7272);
*/
ws = new WebSocket("ws://your_domain.com:7272");
// 服务端主动推送消息时会触发这里的onmessage
ws.onmessage = function(e){
// json数据转换成js对象
var data = eval("("+e.data+")");
var type = data.type || '';
switch(type){
// Events.php中返回的init类型的消息,将client_id发给后台进行uid绑定
case 'init':
// 利用jquery发起ajax请求,将client_id发给后端进行uid绑定
$.post('./bind.php', {client_id: data.client_id}, function(data){}, 'json');
break;
// 当mvc框架调用GatewayClient发消息时直接alert出来
default :
alert(e.data);
}
};
~~~
### mvc后端uid绑定代码片段
bind.php
~~~
<?php
//加载GatewayClient
require_once '/your/path/GatewayClient/Gateway.php';
// GatewayClient 3.0.0版本开始要使用命名空间
use GatewayClient\Gateway;
// 设置GatewayWorker服务的Register服务ip和端口,请根据实际情况改成实际值
Gateway::$registerAddress = '127.0.0.1:1236';
// 假设用户已经登录,用户uid和群组id在session中
$uid = $_SESSION['uid'];
$group_id = $_SESSION['group'];
// client_id与uid绑定
Gateway::bindUid($client_id, $uid);
// 加入某个群组(可调用多次加入多个群组)
Gateway::joinGroup($client_id, $group_id);
~~~
### mvc后端发消息代码片段
send_message.php
~~~
<?php
//加载GatewayClient
require_once '/your/path/GatewayClient/Gateway.php';
// GatewayClient 3.0.0版本开始要使用命名空间
use GatewayClient\Gateway;
// 设置GatewayWorker服务的Register服务ip和端口,请根据实际情况改成实际值
Gateway::$registerAddress = '127.0.0.1:1236';
// 向任意uid的网站页面发送数据
Gateway::sendToUid($uid, $message);
// 向任意群组的网站页面发送数据
Gateway::sendToGroup($group, $message);
~~~
>[danger] 注意
> 以上仅是mvc框架与GatewayWorker官方推荐的结合方式,并不是强制使用此方式,开发者可以自由变化选择结合方式以适应自己的业务需求。 当然也可以采用客户端与GatewayWorker直接双向通讯的方式完成业务通讯。
## 关于GatewayClient
源码:
https://github.com/walkor/GatewayClient
>[danger] 注意:
> 如果GatewayClient和GatewayWorker不是在同一台服务器上,则需要先将start_gateway.php中的lanIp改成当前服务器的内网ip(如果不在一个内网可改成公网ip)。
> 如果GatewayClient和GatewayWorker在同一台服务器上运行,则不用做任何更改,直接按照示例使用GatewayClient即可。
> 通过GatewayClient发送的数据不会经过Event.php,而是直接经由Gateway进程转发给客户端。
> GatewayClient无法接收客户端发来的数据。
## 客户端使用示例
~~~
require_once '/your/path/GatewayClient/Gateway.php';
/**
* gatewayClient 3.0.0及以上版本加了命名空间
* 而3.0.0以下版本不需要use GatewayClient\Gateway;
**/
use GatewayClient\Gateway;
/**
*====这个步骤是必须的====
*这里填写Register服务的ip(通常是运行GatewayWorker的服务器ip)和端口
*注意Register服务端口在start_register.php中可以找到(chat默认是1236)
*这里假设GatewayClient和Register服务都在一台服务器上,ip填写127.0.0.1
**/
Gateway::$registerAddress = '127.0.0.1:1236';
// 以下是调用示例,接口与GatewayWorker环境的接口一致
// 接口具体使用方法见《Lib\Gateway类提供的接口》一章
// 注意除了不支持sendToCurrentClient和closeCurrentClient方法
// 其它方法都支持
Gateway::sendToAll($data);
Gateway::sendToClient($client_id, $data);
Gateway::closeClient($client_id);
Gateway::isOnline($client_id);
Gateway::bindUid($client_id, $uid);
Gateway::isUidOnline($uid);
Gateway::getClientIdByUid($uid);
Gateway::unbindUid($client_id, $uid);
Gateway::sendToUid($uid, $data);
Gateway::joinGroup($client_id, $group);
Gateway::sendToGroup($group, $data);
Gateway::leaveGroup($client_id, $group);
Gateway::getClientCountByGroup($group);
Gateway::getClientSessionsByGroup($group);
Gateway::getAllClientCount();
Gateway::getAllClientSessions();
Gateway::setSession($client_id, $session);
Gateway::updateSession($client_id, $session);
Gateway::getSession($client_id);
...
~~~
- ichat系统说明
- workerman与Thinkphp5整合原理
- ichat系统的基础搭建
- 通用后台的搭建
- workerman的集成
- layIM的集成
- 管理员后台功能的实现
- 后台登录退出的实现
- 群组管理的设计与实现
- 群组基础配置
- 群组管理
- 用户管理
- 聊天设置
- 用户的举报
- 聊天系统的设计与实现
- 注册功能的实现
- 登录功能的实现(1)
- 登录功能的实现(2)
- 登录功能的实现(3)
- 登录功能的实现(4)
- 修改个人资料的实现
- 修改个性签名的实现
- 切换在线状态的实现
- 添加好友的实现
- 消息盒子
- 用意/拒绝好友(1)
- 同意/拒绝好友(2)
- 好友聊天的实现
- 创建群组的实现
- 按条件查找群组
- 申请加入群组
- 管理我的群组
- 群组聊天
- 右键退出群组
- 发送语音
- 发送图片
- 发送文件
- 用户空间功能
- 查看聊天记录
- 进入好友空间
- 将好友加入黑名单
- 移动好友分组
- 删除好友
- 举报好友
- ichat(移动版)
- 登录的实现
- 聊天的实现
- live客服模式
- 数据字典
- 全国区域数据
- 系统整体结构说明
- main.js全部代码
- 源码下载