加入收藏 | 设为首页 | 会员中心 | 我要投稿 聊城站长网 (https://www.0635zz.com/)- 智能语音交互、行业智能、AI应用、云计算、5G!
当前位置: 首页 > 站长学院 > PHP教程 > 正文

基于PHP实现站内信的思路和方法指的是什么

发布时间:2023-06-02 13:42:59 所属栏目:PHP教程 来源:
导读:这篇我们来学习和了解“基于PHP实现站内信的思路和方法是什么”,下文的讲解详细,步骤过程清晰,对大家进一步学习和理解“基于PHP实现站内信的思路和方法是什么”有一定的帮助。有这方面学习需
这篇我们来学习和了解“基于PHP实现站内信的思路和方法是什么”,下文的讲解详细,步骤过程清晰,对大家进一步学习和理解“基于PHP实现站内信的思路和方法是什么”有一定的帮助。有这方面学习需要的朋友就继续往下看吧!
 
当前使用运维平台的用户进行沟通时,更多的是依赖微信和邮件通知,而运维平台作为一个整体的产品,也需要能够进行内部沟通的一种服务 - 站内信。
 
站内信的设计基调
 
站内信的设计基调取决于用户如何使用站内信:
 
用户不会守着运维平台这个页面,等待消息通知,查看消息内容,然后跳转到要操作的页面。
 
也就是说站内信不是第一入口,站内信的实时性意义也不大。
 
同很多社交网站不同(Facebook,知乎,微博等),用户会守在社交网站的主页面,不断刷新新内容,同时检查新消息(主要是个人私信、别人的回复等,也绝不是为了检查系统通知消息)
 
        用户会根据邮件通知,决定是否要进入运维平台进行操作
 
        如果邮件特别多,例如同时有多个工单需要用户处理,用户也会在工单平台提供的“我的待办”页面进行所有工作。
 
        如果邮件被误删了,没有邮件链接直接进入要操作的模块

那么或者通过索要链接/单号的方式,前往指定页面
 
或者直接在相关模块进行搜索
 
上面的描述都意味着用户基本不会使用站内信,那么在什么样的场合会使用站内信呢?
 
    不发邮件,只发站内信的消息通知,例如全站通知、编辑操作、Comment操作等
 
    当具体模块没有详细的操作记录时,可以通过查看站内信的发生时间
 
当前只有产品消息通知,消息展示也没有进行归类聚合,以后增加全站通知、mention、like、comment等类型的站内信时,就需要考虑按类型进行消息聚合了。

二、需求描述
 
站内信通常需要解决两个需求:
 
      用户对用户的站内信,管理员对用户的站内信:即一对一发送
 
      管理员对多用户、用户组、全站的站内信:即一对多发送

(还有一种是用户对产品的站内信,例如对某个模块的反馈、疑问之类的)

我们目前的需求是:
 
1管理员对多用户发送站内信
 
对用户真实性不做校验
 
对标题长度、内容长度进行限制(分别是45个字节、150个字节,对应中文字符15个、50个)
 
对收件人的拼音长度进行限制(最长50个字节)
 
2 用户可以查看自己的站内信
 
按“全部、已读、未读”过滤
 
按消息来源分类:工单平台、资源管理、自动装机、漏洞平台、故障平台。。。
 
3 用户可以删除、批量删除站内信
 
4 用户可以已阅、批量已阅、全部标记为已读 站内信
 
5 运维平台页面顶部的消息图标

展示未读消息数,超过99显示 99+
 
鼠标放上去,会有下拉框,展示最近10条未读消息(展示“时间”,“消息来源”,“标题”)
 
下拉框的底部有两个按钮:“更多”,加载更多未读消息;“查看全部”,跳转到站内信列表页面(最好另开一个窗口)
 
点击下拉框里的未读消息,通过弹出框展示详情;然后在未读列表里删除该记录,在数据库里标记为已读,消息图标的未读消息数量减一
 
6 管理员页面:
 
更新用户
 
删除消息
 
统计数据
 
增加module
 
增加站内信类型
 
发送全站消息
 
三、系统设计
 
功能设计

四、系统流程
 
发送站内信
 
读取POST请求的request body
 
校验长度
 
插入数据库
 
返回

获取站内信列表
 
调用子模块,插入发送给全站或我所属用户组的站内信
 
根据查询条件,返回数据库数据
 
获取未读站内信数量
 
调用子模块,插入发送给全站或我所属用户组的站内信
 
返回数量
 
批量已阅
 
检查messageId是不是属于当前用户
 
inbox_message表里把 read 置为1,修改update_time
 
全部已阅
 
update inbox_message set “read”=1, “update_time”=now where “receiver_name”=currentUser() and “read” = 0  
 
批量删除
 
检查messageId是不是属于当前用户
 
inbox_message表里把 deleted 置为1,修改update_time
 
全部删除
 
update inbox_message set “deleted”=1, “update_time”=now where “receiver_name”=currentUser() and “deleted” = 0  
 
五、数据库设计
 
站内信内容表
 
CREATE TABLE `inbox_message_text` (   `id` bigint(20) NOT NULL AUTO_INCREMENT,   `title` varchar(128) NOT NULL DEFAULT '',   `content` longtext NOT NULL,   `create_time` datetime NOT NULL,   `update_time` datetime NOT NULL,   `send_type` tinyint(4) NOT NULL DEFAULT '0',   `creator_name` varchar(255) NOT NULL DEFAULT '',   `deleted` tinyint(4) NOT NULL DEFAULT '0',   `module_id` bigint(20) NOT NULL,   `link` varchar(255) NOT NULL DEFAULT '',   PRIMARY KEY (`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;  
 
站内信本身除了消息来源(module_name),还有一个纬度的描述,叫消息类型(message_type),例如安全消息、活动消息、服务消息等,每一大类里,又可以划分子类,例如活动消息-优惠活动
 
消息来源和消息类型可以是正交关系,即工单平台也可以有活动消息;消息来源也可以是消息类型的一种,称为“产品消息”
 
站内信发送表
 
CREATE TABLE `inbox_message` (   `id` bigint(20) NOT NULL AUTO_INCREMENT,   `message_text_id` bigint(20) NOT NULL,   `receiver_name` varchar(255) NOT NULL DEFAULT '',   `read` tinyint(4) NOT NULL DEFAULT '0',   `deleted` tinyint(4) NOT NULL DEFAULT '0',   `create_time` datetime NOT NULL,   `update_time` datetime NOT NULL,   PRIMARY KEY (`id`),   KEY `inbox_message_receiver_name_deleted_read_id` (`receiver_name`,`deleted`,`read`,`id`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;  

消息来源表
 
CREATE TABLE `inbox_module` (   `id` bigint(20) NOT NULL AUTO_INCREMENT,   `code` varchar(128) NOT NULL DEFAULT '',   `name` varchar(128) NOT NULL DEFAULT '',   `create_time` datetime NOT NULL,   `update_time` datetime NOT NULL,   PRIMARY KEY (`id`),   UNIQUE KEY `code` (`code`),   UNIQUE KEY `name` (`name`) ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;  
 
六、API设计
 
发送站内信:POST /v1/message
 
request body Content-Type: application/json
 
 
{     "title": "工单审批",     "content": "XXX提交了变更申请,请审批",     "to": "sunzhongyuan,shenli,wangya",     "module_name": "工单平台",     "link": "xxx" }  
 
 
response
 
 
{     "code": 200,     "data": 32,     "msg": "OK" }  
 
 
获取站内信列表:GET /v1/message User-Id: xxx
 
http://127.0.0.1:10085/v1/message?query=message_text_id.module_id.name:xxx&limit=1  

 
{     "code": 200,     "data": {         "data": [             {                 "id": 1,                 "message_text": {                     "id": 1,                     "title": "title 2",                     "content": "content 2",                     "create_time": "2018-01-12 11:13:48",                     "update_time": "2018-01-12 11:13:48",                     "send_type": 1,                     "creator_name": "sysadmin",                     "deleted": 0,                     "link": "xxx",                     "Messages": null,                     "module": {                         "id": 4,                         "code": "secure",                         "name": "xxx",                         "create_time": "2018-01-11 15:38:01",                         "update_time": "2018-01-11 15:38:01",                         "MessageTexts": null                     }                 },                 "receiver_name": "xxx",                 "read": 0,                 "deleted": 0,                 "create_time": "2018-01-12 11:13:48",                 "update_time": "2018-01-12 11:13:48"             }         ],         "total": 2     },     "msg": "OK" }  

注:
 
返回数据的个数是由 limit 限制,而 total 是符合query条件的总数(用于分页)
 
目前没有发送用户组、全站的行为,如果有的话,在获取列表接口里,增加一步“插入所有发送给我所在用户组,或发给全站的,且我自己的站内信列表里没有记录到的站内信”
 
获取未读站内信数量:GET /v1/message/unread_count
 
response

{     "code": 200,     "data": 29,     "msg": "OK" }   
 
获取单个站内信内容:GET /v1/message/:id
 
{     "code": 200,     "data": {         "id": 2,         "message_text": {             "id": 2,             "title": "title 2",             "content": "content 3",             "create_time": "2018-01-12 11:37:54",             "update_time": "2018-01-12 11:37:54",             "send_type": 1,             "creator_name": "sysadmin",             "deleted": 0,             "link": "",             "Messages": null,             "module": {                 "id": 4,                 "code": "secure",                 "name": "xxx",                 "create_time": "2018-01-11 15:38:01",                 "update_time": "2018-01-11 15:38:01",                 "MessageTexts": null             }         },         "receiver_name": "xxx",         "read": 1,         "deleted": 0,         "create_time": "2018-01-12 11:37:54",         "update_time": "2018-01-22 17:33:20"     },     "msg": "OK" }  
 
 
已阅、批量已阅站内信:PUT /v1/read_messages/:messageIds
 
response
 
 
{     "code": 200,     "data": "OK",     "msg": "OK" }  
 
全部已阅 PUT:/v1/read_all_messages
 
response 同上
 
删除、批量删除站内信:PUT /v1/delete_messages/:messageIds
 
response 同上

全部删除站内信:PUT /v1/delete_all_messages
 
response 同上
 
获取消息来源列表:GET /v1/module
 
response
 
 
{     "code": 200,     "data": [         {             "id": 1,             "code": "worksheet",             "name": "工单平台",             "create_time": "2018-01-11 15:21:38",             "update_time": "2018-01-11 15:21:38",             "MessageTexts": null         },         {             "id": 2,             "code": "cmdb",             "name": "资源管理",             "create_time": "2018-01-11 15:22:28",             "update_time": "2018-01-11 15:22:28",             "MessageTexts": null         },         ...     ],     "msg": "OK" }  
 
七、测试注意点
 
1 发送站内信
 
纯接口
 
收件用户以逗号分割,真实性不做校验
 
收件用户有长度校验,50个字节
 
title content 有长度校验,分别是45,150个字节
 
module_name 是一个列表,必须从这里选一个
 
2 其他接口都可以通过前端页面测试

八、优化
 
未读列表可以加上粗体显示,已读则是普通字体
 
对站内信进行分类,打上不同纬度的标签,方便过滤、搜索、屏蔽
 
用户可以设置允许接收的站内信的消息来源
 
管理员可以对全站消息、全站人员、全站的消息属性进行增删改查,比如撤销某个站内信,让所有人都看不见
 
管理员可以统计站内信的发送数量、各产品的使用情况、消息被读的比例、消息被读的时间、消息被读的方式(点开还是批量操作),等

九、关键功能点设计
 
右上角的图标行为
 
1 点击图标,展示最近的N条未读消息

展示下拉框
 
实时获取最近N条未读消息
 
N可以为5~10,具体数值取决于下拉框的高度限制
 
当未读数不足N时,下拉框能自适应高度
 
如果没有未读消息,展示”暂无新消息”
 
停止每10秒的获取未读消息数接口

2 下拉框里,展示消息来源、时间(相对现在的时间:10分钟前)、title
 
向下滑动下拉框,展示更多未读消息(只获取id小于已展示消息列表里的最小id,即不获取点击图标后新来的消息)

3 点击下拉框里的某一个消息

下拉框不消失
 
依然停止每10秒的获取未读消息数接口
 
未读消息数减1
 
未读消息列表删除当前消息(slice)
 
展示弹出框

4 弹出框展示消息的来源、时间(绝对时间)、title、content
 
5 关闭弹出框或者点击外围:

弹出框消失
 
下拉框不消失
 
可以继续点击某一个未读消息
 
6 再次点击下拉框和图标的外围

下拉框消失
 
清空已有的未读消息列表
 
恢复每10秒的获取未读消息数接口

7 再次点击图标,重新回到#1状态

阿里云的图标行为是:
 
刷新页面的时候才会请求一次未读消息数,之后不再定时刷新(当然也可能是刷新时间间隔比较长,没发现;又或者采用了 socket 的方式,建立了一个长链接)
 
hover图标,即显示未读消息的下拉框
 
点击图标,进入站内信管理页面,默认是“未读消息”
 
4 点击未读消息,新开一个Tab,展示该消息的详情(detail页面),原Tab内容不变,即没有未读数减一,也没从下拉框里删除刚点击的消息
 
5 最多展示5条消息,只要不刷新页面,就一直是这5条
 
6 没有滚动更多的功能,只有查看更多,点击进入站内信管理页面,默认是“未读消息”

和点击图标的区别是:点击图标直接当前页面跳转到站内信管理页面,点击“查看更多”会新建一个Tab
 
7 多了一个“消息接受管理”的按钮,当前页面跳转到站内信管理页面,但是默认即“基本接收管理”
 
隐藏浏览器进度条
 
每10秒的获取未读消息数接口,会触发浏览器展示进度条,导致分散用户注意力,要把这个进度条隐藏掉。
 
其他刷新页面的行为不受影响。
 
 

(编辑:聊城站长网)

【声明】本站内容均来自网络,其相关言论仅代表作者个人观点,不代表本站立场。若无意侵犯到您的权利,请及时与联系站长删除相关内容!