博客列表 >仿百度商桥项目-实现商桥客户和客服点对点通信

仿百度商桥项目-实现商桥客户和客服点对点通信

岂几岂几
岂几岂几原创
2020年07月04日 00:44:041160浏览

实现商桥客户和客服点对点通信

学习心得

  • 因为所有操作都通过消息内容来辨别操作类型和操作对象, 所以理解起来比较绕, 好在经过西门老师的耐心讲解, 自己也基本能实现了.

  • 待解决的问题: 用户刷新浏览器, 相当于执行下线, 换个马甲再上线的操作, 这样没法使用连接对象id来标识用户. 可以考虑, 使用保存在 cookie 中的客户信息, 如客户id等, 作为两个全局数组的key值来标识用户及其当前链接对象. 两个全局数组再放入高速缓存, 如 Redis 中, 问题可解.

1. 实现思路

    1. 客户端的用户类型分为 客户客服 两种, 实例只实现 客户客服 点对点通信.
    1. 客户端发送的消息分为: 当客户端成功创建跟服务器的链接时, 发送的包含客户端类型(客户或客服)的上线消息; 客户端和客户端之间, 通过服务器转发的聊天信息; 客户端下线(断开链接)时, 发送的下线消息.
    1. 使用通信的数据辨别通信行为. 约定通信的数据数组中包含以下元素(发送时转换成json字符串):
    • 1.1 msg 元素, 值为要发送的消息正文.
    • 1.2 type 元素, 用于区分发送的消息类别; 值为 login 时, 表示有新客户端跟服务器成功创建链接时发送的身份信息; 值为 msg 时, 表示此次发送的是聊天信息; 值为 logout 时, 表示发送消息的客户端将断开链接.
    • 1.3 from_id 元素, 用户保存发送消息的客户端 链接id , 若为系统发送消息, 则值为 system .
    • 1.4 sendId 元素, 值为发送消息的客户端希望服务器把消息转发给的目标客户端 链接id .
    • 1.5 group 元素, 用来区分发送消息的客户端用户类型, member 值表示用户为 客户 , admin 值表示用户为 客服 .
    • 1.6 custom_id 元素, 客户 成功创建链接时, 系统给跟该用户对接的 客服 发送客户上线的消息, 此时 from_id 被设置为 system , 所以使用 custom_id 元素指定上线的 客户 客户端id; 当 客户 断开连接时, 系统给跟该用户对接的 客服 发送客户下线消息, 此时 from_id 被设置为 sytem , 所以使用 custom_id 元素指定下线的 客户 客户端链接id.
    1. 客户端链接成功后, 发送上线消息到服务器, 服务器根据消息中的属性值, 执行不同的处理.
    • 在链接对象中设置 group 属性, 值等于上线消息中的 group 元素值, 标识该链接是 客户 还是 客服 链接.
    • 创建两个全局数组, 分别保存 客户 链接和 客服 链接. key为链接id, 值为链接对象.
    • 若是 客服 客户端发来的上线消息, 则把发送消息的 客服 链接放入 客服 全局数组即可.
    • 若是 客户 客户端发送来的上线消息
      • 把发送消息的 客户 链接放入 客户 全局数组;
      • 使用 array_rand() 函数从 客服 数组中随机获取一个 客服 链接id, 分配给当前 客户 . 若当前没有 客服 , 则服务器给当前 客户 链接的客户端发送消息, 让客户端过一会儿刷新重试.
      • 若随机到 客服 , 则把 客服 id设置到当前 客户sendId 属性, 然后服务器给随机到的 客服 链接的客户端发送消息, 通知该 客服 有新 客服 上线, 客服 客户端前端的 客户 列表新增当前 客户 项.
    1. 客户 客户端发送聊天消息到服务器, 服务器根据消息中的 sendId 元素值, 从全局 客服 数组中获取对应的 客服 链接对象, 若获取不到, 则服务器发送系统消息提示 客户 客户端刷新界面重新创建链接来获取 客服 链接. 若获取到对象, 则转发消息给该 客服 对象.
    1. 客服 客户端点击 客户 列表中的 客户 , 获取其 客户 链接id , 组装成消息发送给服务器. 服务器的处理跟 客户 客户端发送消息的处理类似.
    1. 客户 客户端下线(关闭浏览器/刷新浏览器)时, 给服务器发送下线消息, 服务器通过发送消息的 客户 链接id, 将其从 客户 全局数组中移除, 并根据消息中的 sendId 给负责该客户的 客服 链接发送系统消息, 通知该 客服 , 客户 下线的消息.
    1. 客服 客户端下线时, 给服务器发送下线消息, 服务器同样先根据其id从 客服 全局数组中移除, 再遍历 客户 全局数组, 找到其负责的 客户 链接(可以优化的点, 可以在 客服 发送的消息中带上其负责的 客户 id), 为其重新分配 客服 .

2. 代码清单

    1. 服务端
  1. <?php
  2. use Workerman\Worker;
  3. require_once __DIR__ . '/workerman/Autoloader.php';
  4. // 注意:这里与上个例子不同,使用的是websocket协议
  5. $ws_worker = new Worker("websocket://0.0.0.0:2000");
  6. // 启动4个进程对外提供服务
  7. $ws_worker->count = 4;
  8. /* 创建全局连接数组,key=连接的id,val=连接; 因为存在客户可能刷新浏览器页面, 触发websocket给同一个客户再分配一个新的连接id
  9. * 所以, 一般是用客户保存在数据表中的用户id来做key, 每次刷新, 用户id都跟最新分配的连接关联, 就能解决用户刷新的问题了.
  10. * 用户id从哪来? 可以在登录成功后把用户id保存到cookie中.
  11. * 另一种方案: 把$conns链接数组保存到缓存(如: Redis)中, 同样用用户id做key, 序列化/json格式化的连接做value.
  12. */
  13. // 客户连接数组
  14. $customerConns = [];
  15. // 客服连接数组
  16. $servicerConns = [];
  17. // 当收到客户端发来的数据后返回hello $data给客户端
  18. $ws_worker->onMessage = function($connection, $data)
  19. {
  20. global $customerConns;
  21. global $servicerConns;
  22. // 分辨用户类型, 只能客户和客服之间通信.
  23. // 判断客户端模拟用户登录状态的标识type, 若值为login标识登录成功. 则把用户的类型(客户/客服)
  24. // 以自定义属性的方式设置到$connection(即连接)中
  25. // json->数组
  26. $data = json_decode($data, true);
  27. if($data['type'] == 'login') {
  28. var_dump($connection->id);
  29. // 给连接动态加入group属性,标识[客户]和[客服]
  30. $connection->group = $data['group'];
  31. // 模拟"登录"的连接,放入到对应连接数组中
  32. if($data['group'] == 'admin') {// admin标识为[客服]
  33. $servicerConns[$connection->id] = $connection;
  34. } else {// member标识为[客户]
  35. $customerConns[$connection->id] = $connection;
  36. // 如果是客户登录, 还需要给他安排一个客服(array_rand()函数随机返回数组元素的key值)
  37. $connection->sendId = array_rand($servicerConns, 1);
  38. // 没有小姐姐可供分配
  39. if(!is_numeric($connection->sendId)) {
  40. $sendInfo['from_id'] = 'system';
  41. $sendInfo['type'] = 'msg';
  42. $sendInfo['msg'] = '暂无客服小姐姐在线, 请稍后刷新重试';
  43. $connection->send(json_encode($sendInfo));
  44. var_dump('暂无客服小姐姐');
  45. return;
  46. }
  47. var_dump('给id为' . $connection->id .'的客户分配的是id为' . $connection->sendId . '的客服小姐姐');
  48. // 通知这位客服, 有新客户进来
  49. $target = $servicerConns[$connection->sendId];
  50. $sendInfo['from_id'] = 'system';
  51. $sendInfo['custom_id'] = $connection->id;
  52. $sendInfo['type'] = 'login';
  53. $sendInfo['msg'] = '有新客户登录, id为:' . $connection->id;
  54. $target->send(json_encode($sendInfo));
  55. }
  56. } else if($data['type'] == 'msg') {// 模拟"发送数据"的连接
  57. // 判断发送数据的连接是[客服]还是[客户]
  58. if($connection->group == 'member') {// 客户
  59. if(!is_numeric($connection->sendId)) {
  60. $sendInfo['from_id'] = 'system';
  61. $sendInfo['type'] = 'msg';
  62. $sendInfo['msg'] = '暂无客服小姐姐在线, 请稍后刷新重试';
  63. $connection->send(json_encode($sendInfo));
  64. var_dump('暂无客服小姐姐');
  65. return;
  66. }
  67. // 获取在客户登录时指定的客服连接
  68. $target = $servicerConns[$connection->sendId];
  69. var_dump('给id为' . $connection->sendId . '的客服小姐姐发信息');
  70. // 把发送消息的连接id设置到要发送的数据中
  71. $sendInfo['from_id'] = $connection->id;
  72. $sendInfo['msg'] = $data['msg'];
  73. // 给要发送消息的对象发送消息
  74. $target->send(json_encode($sendInfo));
  75. } else if($connection->group == 'admin') {// 客服
  76. $customer_id = $data['sendId'];
  77. if(!is_numeric($customer_id)) {
  78. $sendInfo['type'] = 'msg';
  79. $sendInfo['msg'] = '该客户不存在, 可能已下线';
  80. $sendInfo['from_id'] = 'system';
  81. $connection->send(json_encode($sendInfo));
  82. return;
  83. }
  84. // 获取要发送消息的客户连接
  85. if(!isset($customerConns[$customer_id])) {
  86. $sendInfo['type'] = 'msg';
  87. $sendInfo['msg'] = '该客户不存在, 可能已下线!';
  88. $sendInfo['from_id'] = 'system';
  89. $connection->send(json_encode($sendInfo));
  90. return;
  91. }
  92. $target = $customerConns[$customer_id];
  93. $sendInfo['type'] = 'msg';
  94. $sendInfo['msg'] = $data['msg'];
  95. $sendInfo['from_id'] = $connection->id;
  96. $target->send(json_encode($sendInfo));
  97. }
  98. }
  99. // 群发消息
  100. /* global $ws_worker;
  101. foreach($ws_worker->connections as $conn) {
  102. $conn->send('hello');
  103. } */
  104. // 向客户端发送hello $data
  105. // $connection->send('hello ' . $data);
  106. };
  107. // 当有连接断开时
  108. $ws_worker->onClose = function($connection) {
  109. global $servicerConns;
  110. global $customerConns;
  111. if($connection->group == 'admin') {// 客服断开
  112. $unconnId = $connection->id;
  113. // 把断开的客服连接移除出客服连接数组
  114. unset($servicerConns[$connection->id]);
  115. var_dump('客服' . $unconnId . '下线了');
  116. // 客服断开, 需要给该客服负责的客户重新分配新客服
  117. foreach($customerConns as $customerConn) {
  118. if($customerConn->sendId == $unconnId) {// 该客服小姐姐负责的客户
  119. $customerConn->sendId = array_rand($servicerConns, 1);
  120. // 没分配到客服小姐姐, 直接结束分配.
  121. if(!is_numeric($customerConn->sendId)) {
  122. var_dump('当前没有客服小姐姐');
  123. continue;
  124. }
  125. var_dump('重新给客户' . $customerConn->id . '分配新的客服小姐姐:' . $customerConn->sendId);
  126. // 新分配的客服小姐姐的连接
  127. $target = $servicerConns[$customerConn->sendId];
  128. // 给新分配到的客服小姐姐发分配消息
  129. $sendInfo['from_id'] = 'system';
  130. $sendInfo['custom_id'] = $customerConn->id;
  131. $sendInfo['type'] = 'login';
  132. $sendInfo['msg'] = '有新客户登录, id为:' . $customerConn->id;
  133. $target->send(json_encode($sendInfo));
  134. }
  135. }
  136. } else {// 客户断开
  137. // 断开的客户连接id
  138. $unconnId = $connection->id;
  139. var_dump('客户' . $unconnId . '下线了');
  140. // 负责该客户的客服小姐姐id
  141. $servicerId = $connection->sendId;
  142. // 把断开的客户连接移除出客户连接数组
  143. unset($customerConns[$connection->id]);
  144. if(!is_numeric($servicerId)) {// 判断断开的客户是否有客服接待, 没有, 则直接断开客户连接;
  145. return;
  146. }
  147. // 客户断开, 系统给负责该客户的客服发消息, 不必再负责该客户
  148. $target = $servicerConns[$servicerId];
  149. $sendInfo['from_id'] = 'system';
  150. $sendInfo['msg'] = '客户' . $unconnId . '跟你说了声拜拜后, 下线了';
  151. $sendInfo['custom_id'] = $unconnId;
  152. $sendInfo['type'] = 'logout';
  153. $target->send(json_encode($sendInfo));
  154. }
  155. };
  156. // 运行worker
  157. Worker::runAll();
    1. 客户 客户端
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="UTF-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6. <title>"百度商桥"客户端</title>
  7. <link rel="stylesheet" href="/static/plugin/layui/css/layui.css" media="all">
  8. <script src="/static/plugin/layui/layui.js"></script>
  9. <script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.5.1/jquery.js"></script>
  10. <style>
  11. * {
  12. margin: 0;
  13. padding: 0;
  14. box-sizing: border-box;
  15. }
  16. body {
  17. background-color: #fafafa;
  18. }
  19. .im {
  20. width: 400px;
  21. height: 520px;
  22. background-color: wheat;
  23. margin: 40px auto;
  24. padding: 10px;
  25. }
  26. .im .history {
  27. background-color: white;
  28. border: 1px solid #aaa;
  29. width: 100%;
  30. height: 290px;
  31. padding: 5px;
  32. overflow-y: auto;
  33. }
  34. .im .inputing {
  35. background-color: white;
  36. border: 1px solid #aaa;
  37. width: 100%;
  38. height: 150px;
  39. margin-top: 10px;
  40. padding: 5px;
  41. outline: none;
  42. }
  43. .im .btn-area {
  44. width: 100%;
  45. text-align: right;
  46. margin-top: 10px;
  47. }
  48. .msg-box-friend {
  49. padding: 10px;
  50. width: 75%;
  51. margin: 5px auto 0 5px;
  52. background-color: lightblue;
  53. border: 1px solid #ccc;
  54. border-radius: 5px;
  55. /* overflow-x: wordwrap; */
  56. white-space:normal;
  57. }
  58. .msg-box-me {
  59. padding: 10px;
  60. width: 75%;
  61. margin: 5px 5px 0 auto;
  62. background-color: wheat;
  63. border: 1px solid #ccc;
  64. border-radius: 5px;
  65. /* overflow-x: wordwrap; */
  66. white-space:normal;
  67. }
  68. </style>
  69. </head>
  70. <body>
  71. <div class="im">
  72. <div class="history">
  73. </div>
  74. <!-- contenteditable="true", 这个div就可编辑了 -->
  75. <div class="inputing" contenteditable="true">
  76. </div>
  77. <div class="btn-area">
  78. <span class="layui-btn layui-btn-success" onclick="send()">发送</span>
  79. </div>
  80. </div>
  81. </body>
  82. <script>
  83. layui.use(['layer'], function() {
  84. layer = layui.layer;
  85. });
  86. // 假设服务端ip为127.0.0.1
  87. ws = new WebSocket("ws://127.0.0.1:2000");
  88. /* 当客户端连通服务器端的时候 */
  89. ws.onopen = function() {
  90. // 当客户端连通服务端时, 把当前客户端的用户标识(客户/客服)发给服务端
  91. var data = {};
  92. // js对象的属性可以自定义. type: login, 标识用户行为为声明登录;type: msg, 标识用户行为为发送消息。
  93. data.type = 'login';
  94. // 约定admin表示登录的用户是客户
  95. data.group = 'member';
  96. // 发送JSON格式的数据
  97. ws.send(JSON.stringify(data));
  98. };
  99. ws.onmessage = function(e) {
  100. // alert("收到服务端的消息:" + e.data);
  101. var receive = JSON.parse(e.data);
  102. var str = "<div class='msg-box-friend'>"+receive.from_id+"说: "+receive.msg+"</div>";
  103. $(str).appendTo('.history');
  104. };
  105. function send() {
  106. // 消息框
  107. var str = "<div class='msg-box-me'>我说: "+$('.inputing').html()+"</div>";
  108. var data = {};
  109. // 标识此次发送的数据是发送消息
  110. data.type='msg';
  111. // 标识是从客服端发的
  112. data.group = 'admin'
  113. // 标识私聊的对象id,0标识群发. DEL_客户连接时由系统随机分配客服小姐姐, 不需要手动指定了
  114. // data.sendId = 0;
  115. // 要发送的消息
  116. data.msg = $('.inputing').html();
  117. // 在消息历史中显示发送的消息
  118. $(str).appendTo('.history');
  119. // 发送JSON格式的数据
  120. ws.send(JSON.stringify(data));
  121. $('.inputing').html('');
  122. }
  123. </script>
  124. </html>
    1. 客服 客户端
  1. <!DOCTYPE html>
  2. <html lang="en">
  3. <head>
  4. <meta charset="UTF-8">
  5. <meta name="viewport" content="width=device-width, initial-scale=1.0">
  6. <title>"百度商桥"客服端</title>
  7. <link rel="stylesheet" href="/static/plugin/layui/css/layui.css" media="all">
  8. <script src="/static/plugin/layui/layui.js"></script>
  9. <script src="https://cdn.bootcdn.net/ajax/libs/jquery/3.5.1/jquery.js"></script>
  10. <style>
  11. * {
  12. padding: 0;
  13. margin: 0;
  14. box-sizing: border-box;
  15. }
  16. body {
  17. padding: 10px;
  18. width: 100vw;
  19. height: 100vh;
  20. background-color: #f0f0f0;
  21. display: grid;
  22. gap: 10px;
  23. grid-template-columns: 240px auto;
  24. grid-template-rows: 3fr 2fr;
  25. grid-template-areas:
  26. "customer-list message-list"
  27. "customer-list message-send";
  28. }
  29. .customer-list {
  30. grid-area: customer-list;
  31. background-color: white;
  32. border: 1px solid #ccc;
  33. }
  34. .message-list {
  35. grid-area: message-list;
  36. background-color: white;
  37. overflow-y: auto;
  38. }
  39. .message-send {
  40. display: grid;
  41. grid-auto-rows: auto 40px;
  42. grid-area: message-send;
  43. background-color: white;
  44. padding: 10px;
  45. }
  46. .message-send > .message-input-area {
  47. padding: 5px;
  48. background-color: #fafafa;
  49. border: 1px solid #ccc;
  50. margin-bottom: 10px;
  51. border-radius: 5px;
  52. outline: none;
  53. overflow-y: auto;
  54. }
  55. .message-send > .message-input-area:hover {
  56. box-shadow: 0px 0px 1px #333;
  57. }
  58. .message-send > .btn-area {
  59. width: 100%;
  60. text-align: right;
  61. }
  62. .msg-box-friend {
  63. padding: 10px;
  64. width: 75%;
  65. margin: 5px auto 0 5px;
  66. background-color: lightblue;
  67. border: 1px solid #ccc;
  68. border-radius: 5px;
  69. /* overflow-x: wordwrap; */
  70. white-space:normal;
  71. }
  72. .msg-box-me {
  73. padding: 10px;
  74. width: 75%;
  75. margin: 5px 5px 0 auto;
  76. background-color: wheat;
  77. border: 1px solid #ccc;
  78. border-radius: 5px;
  79. /* overflow-x: wordwrap; */
  80. white-space:normal;
  81. }
  82. .customer-item {
  83. border: 1px solid #e0e0e0;
  84. border-radius: 5px;
  85. margin: 5px;
  86. padding: 5px 10px;
  87. }
  88. .active {
  89. background-color: skyblue;
  90. }
  91. </style>
  92. </head>
  93. <body>
  94. <!-- 客户列表 -->
  95. <div class="customer-list">
  96. </div>
  97. <!-- 消息记录 -->
  98. <div class="message-list">
  99. </div>
  100. <!-- 发送消息 -->
  101. <div class="message-send">
  102. <div class="message-input-area" contenteditable="true">
  103. </div>
  104. <div class="btn-area">
  105. <span class="layui-btn layui-btn-success" onclick="send()">发送</span>
  106. </div>
  107. </div>
  108. </body>
  109. <script>
  110. layui.use(['layer'], function() {
  111. layer = layui.layer;
  112. $ = layui.jquery;
  113. });
  114. // 假设服务端ip为127.0.0.1
  115. ws = new WebSocket("ws://127.0.0.1:2000");
  116. /* 当客户端连通服务器端的时候 */
  117. ws.onopen = function() {
  118. // 当客户端连通服务端时, 把当前客户端的用户标识(客户/客服)发给服务端
  119. var data = {};
  120. // js对象的属性可以自定义. type: login, 标识用户行为为声明登录;type: msg, 标识用户行为为发送消息。
  121. data.type = 'login';
  122. // 约定admin代表登录的用户是客服
  123. data.group = 'admin';
  124. // 发送JSON格式的数据
  125. ws.send(JSON.stringify(data));
  126. };
  127. ws.onmessage = function(e) {
  128. var data = JSON.parse(e.data);
  129. // alert("收到服务端的消息:" + e.data);
  130. var str = "<div class='msg-box-friend'>"+data.from_id+"说: "+data.msg+"</div>";
  131. $(str).appendTo('.message-list');
  132. // 系统发来的消息, 表示有新客户接入, 并分配到当前客服小姐姐
  133. if(data.from_id == 'system' && data.type == 'login') {
  134. var customer = '<div class="customer-item" data-id="'+data.custom_id+'" onclick="talkTo(this)">客户'+data.custom_id+'</div>';
  135. $(customer).appendTo('.customer-list');
  136. } else if(data.from_id == 'system' && data.type == 'logout') {
  137. $('.customer-item[data-id="'+data.custom_id+'"]').remove();
  138. }
  139. };
  140. function talkTo(ele) {
  141. $(ele).siblings().removeClass('active');
  142. $(ele).addClass('active');
  143. }
  144. function send() {
  145. var str = "<div class='msg-box-me'>我说: "+$('.message-input-area').html()+"</div>";
  146. var data = {};
  147. // 标识此次发送的数据是发送消息
  148. data.type='msg';
  149. // 标识是从客服端发的
  150. data.group = 'admin'
  151. // 获取当前选中的客户
  152. var customer_id = $('div[class*=active]').data('id');
  153. if(isNaN(customer_id)) {
  154. return layer.alert('请先选中一个客户, 再发送消息.');
  155. }
  156. data.sendId = customer_id;
  157. // 要发送的消息
  158. data.msg = $('.message-input-area').html();
  159. $(str).appendTo('.message-list');
  160. // 转成json字符串发送。
  161. ws.send(JSON.stringify(data));
  162. $('.message-input-area').html('');
  163. }
  164. </script>
  165. </html>
  • 路由, 略.
声明:本文内容转载自脚本之家,由网友自发贡献,版权归原作者所有,如您发现涉嫌抄袭侵权,请联系admin@php.cn 核实处理。
全部评论
文明上网理性发言,请遵守新闻评论服务协议