微擎url模式解读_微擎开发文档之微擎执行主流程介绍
首先对微擎的工作原理做简单描述, 微擎使用规则和模块的机制来处理公众平台的请求数据并返回响应的结果.
执行流程描述为: 粉丝用户与公众号码进行对话或交互, 而后公众平台将粉丝用户的请求消息(当前包括: 文本, 图片, 位置, 链接, 事件. 请参阅消息类型)传递给微擎系统, 微擎系统按照消息类型和对应的公众号所设定的规则列表匹配到合适的规则(请参阅消息路由), 规则定义中包括处理此消息所使用的模块和此模块处理消息时所需要的其他附加数据(请参阅模块定义), 而后模块将会按照请求的消息数据和模块附加数据进行相关业务处理并返回处理结果(请参阅响应类型), 微擎系统将处理结果返回给公众平台, 而后经公众平台返回给粉丝用户.
微擎的主处理流程实现定义于: engine.php 中, 如有需要请参阅源码.
消息类型
消息类型指粉丝用户通过公众平台与微擎进行交互时所提供的消息数据的类型. 消息类型基于微信公众平台提供的数据接口, 微擎在其基础上进行包装处理, 方便PHP开发者进行业务处理. 保存消息的基本对象结构定义为:$message => array(
'from' => '', //string: 发送消息方, 代表一个粉丝用户(使用OpenID表示)
'to' => '',//string: 消息接收方, 对应当前的公众号(使用OpenID表示)
'time' => '', //int: 消息发送时间, 使用Unix时间戳表示
'type' => '', //string: 消息类型, 用于区分不同类型的消息, 请参阅下文
'msgid' => '' //int: 消息ID, 公众平台系统用于唯一标识一条请求消息
);
消息类型同公众平台官方不同之处在于将event类型拆分开为独立的消息类型, 避免了重复判断. 根据消息类型不同, 消息对象结构还存在不同的附加数据, 按照类型定义如下:文本消息
粉丝用户向公众号发送了一条普通文本消息(包括包含表情的消息, 或者纯表情消息), 处理文本消息可以实现简单的文本对话, 结合使用文本上下文(请参阅上下文处理)可以实现调查, 测试等复杂的交互.$message => array(
//....全局数据
'type' => 'text', //string: 代表当前消息为文本消息
'content' => '' //string: 文本消息内容
);图片消息
粉丝用户向公众号发送了一张图片, 处理图片消息可以实现分享用户图片的相关功能$message => array(
//....全局数据
'type' => 'image', //string: 代表当前消息为图片消息
'url' => 'http://same.im/image.jpg' //string: 用户所发送的图片地址
);地理位置消息
粉丝用户向公众号发送了一条地理位置, 处理地理位置消息可以实现lbs相关功能(参阅LBS方案)$message => array(
//....全局数据
'type' => 'location', //string: 代表当前消息为位置消息
'location_x' => '', //float: 代表位置经度
'location_y' => '', //float: 代表位置纬度
'scale' => '', //int: 表示地图缩放倍数
'label' => '' //float: 表示地点描述
);链接消息
粉丝用户向公众号发送了一条链接消息, 处理链接消息可以实现好友分享等社交功能$message => array(
//....全局数据
'type' => 'link', //string: 代表当前消息为链接消息
'title' => '', //float: 代表链接标题
'description' => '',//float: 代表链接描述信息
'scale' => 'url'//int: 表示链接的URL
);关注消息
粉丝用户关注当前公众号后将会获得此消息, 处理此消息可以实现欢迎信息和粉丝增长统计$message => array(
//....全局数据
'type' => 'subscribe' //string: 代表当前消息为关注消息
);取消关注消息
粉丝用户取消关注当前公众号后将会获得此消息, 处理此消息可以实现粉丝数量增长分析$message => array(
//....全局数据
'type' => 'unsubscribe' //string: 代表当前消息为取消关注消息
);菜单点击消息
粉丝用户点击自定菜单后, 如果菜单设置为消息回复, 那么将会获得此消息, 处理此消息能实现自定义菜单的特定回复$message => array(
//....全局数据
'type' => 'CLICK', //string: 代表当前消息为菜单点击消息
'eventkey' => ''//string: 菜单点击附加的菜单数据信息
);
消息路由
消息路由是指粉丝用户经公众平台发送消息内容至微擎时, 微擎系统查找对应的规则记录, 并将消息分配至合适的模块处理的过程. 微擎系统按照不同的消息类型, 进行不同的处理. 处理方式如下:上下文消息路由
微擎支持上下文操作, 通过上下文支持微擎可将用户对话锁定至特定的模块, 如果当前消息是上下文对话的消息, 那么将会自动路由至上下文锁定的模块. (请参阅 上下文处理)
'文本消息规则匹配(重要)
针对文本消息, 微擎使用文本匹配来选择合适的规则和模块, 规则是指针对特定消息的处理方式. 微擎选择规则的方式包括:* 关键字包含 指粉丝用户发送的消息内容含有指定的关键字就指派到特定规则.
* 内容等价 指粉丝用户发送的消息内容完全等于指定的内容才指派到特定规则.
* 正则表达式 指粉丝用户发送的消息类型符合指定正则表达式定义的模式时指派到特定规则.(高级模式, 需要有编程经验)其他类型消息路由规则
图片消息, 位置消息, 链接消息等其他类型请求消息的路由支持正在紧张开发中
模块定义
上下文处理
微擎现已支持上下文锁定对话, 可以将粉丝用户的对话锁定至特定模块. 用以实现在线调查, 在线测试等类似的功能. 微擎的上下文操作使用 $_SESSION + DB 来实现.上下文数据保存在$_SESSION['context']变量中,并与sessions表中数据做一对一的映射,用户可通过操作sessions表中的数据进行上下文会话的基本管理. 要实现上下文操作主要使用 Processor 里的内定方法:public inContext;
本次对话是否为上下文响应对话, 如果当前对话是由上下文锁定而路由到的. 此值为 true, 否则为 false
protected function beginContext($expire = 3600);
请在模块处理程序中调用此函数已开始一个新的上下文对话.
附加的参数 $expire 说明本次会话的失效时间. 例如 $this->beginContext(1800) 就说明启动一次上下文会话锁定, 并且本次会话将会于30分钟后释放, 如果不固定超时的话, 请在每次请求时调用 beginContext
protected function endContext();
在模块处理程序中调用 endContext 来结束一次会话, 并销毁会话中保存的所有数据(当前为 $_SESSION)
protected function refreshContext($expire = 0); 在模块处理程序中调用 refreshContext 来刷新用户处于上下文的时限.超过时限用户将会自动退出上文环境.
protected function addParamContext($var, $val = ''); 在模块处理程序中调用 addParamContext 用于增加上下文中的附加数据,此数据将会一直存在于上下文消息中,用户可通过 $this->context 变量来调用保存的数据.
下面的示例将演示根据血型查性格的简单例子:class BloodTestModuleProcessor extends WeModuleProcessor {
//void: 所有处理程序必须实现虚函数 respond. 用以响应消息
public function respond() {
if(!$this->inContext) {
$reply = '请输入你的血型(A, B, O, AB), 来分析你今年的运程. ';
$this->beginContext();
// 如果是按照规则触发到本模块, 那么先输出提示问题语句, 并启动上下文来锁定会话, 以保证下次回复依然执行到本模块
} else {
$btypes = array('a', 'b', 'o', 'ab');
$b = strtolower($this->message['content']);
// 如果当前会话在上下文中, 那么表示当前回复是用户回答提示问题的答案.
if(in_array($b, $btypes)) {
switch($b) {
case 'a':
$reply = 'A型血今年.....';
break;
case 'b':
$reply = 'B型血今年.....';
break;
case 'o':
$reply = 'O型血今年.....';
break;
case 'ab':
$reply = 'AB型血今年.....';
break;
}
$this->endContext();
// 如果当前回答符合答案格式, 那么进行保存并进行下一个问题. (可以保存至 SESSION 中)
// 直到最后一个问题回答完成, 输出测试结果给用户, 并结束对话锁定. 以保证用户其他对话能正常路由.
// 本示例只有一个问题, 因此不保存答案, 直接输出测试结果.
// 如果对话默认的超时不够, 那么可以在每次提出下一个问题的时候重新调用 beginContext 来顺延超时.
} else {
$reply = '请输入正确的血型(A, B, O, AB). ';
// 回答不符合答案格式, 那么重新显示当前问题.
}
}
return $this->respText($reply);
// 返回至系统
}
private function respText($content) {
$response = array();
$response['FromUserName'] = $this->message['to'];
$response['ToUserName'] = $this->message['from'];
$response['MsgType'] = 'text';
$response['Content'] = htmlspecialchars_decode($content);
return $response;
}
}
LBS解决方案
基于位置的数据解决方案正在紧张开发中
微擎url模式解读_微擎开发文档之微擎执行主流程介绍相关推荐
- 微擎url模式解读_微擎系统全局变量说明 - 微擎(WEIQING) – 黑锐源码社区 – bbs.heirui.cn...
$_GPC - 全局请求变量类型: array 说明: 合并请求参数, 包括 $_GET, $_POST, $_COOKIE的内容. 相同键名覆盖规则为 $_COOKIE 覆盖 $_POST, $_P ...
- 微擎url模式解读_微擎常用开发文档
1.tpl_form_field_daterange() - 范围日期选择器 tpl_form_field_daterange($name, $value = array(), $time = fal ...
- 去除Android开发文档中的URL,加速你的Android开发文档
本工具是CSDN的网友写的小程序,作用是去除掉Android帮助文档(网页形式)中的连接到Google的URL,从而加快帮助文档网页的显示速度. 该小工具下载地址:http://pan.baidu.c ...
- java 自动生成文档_[原]java开发文档的自动生成方式
对于Java注释我们主要了解三种: // 注释一行 /* ...... */ 注释若干行 第三种,文档注释: /** ...... */ 注释若干行,并写入 javadoc 文档 通常这种注释的多行写 ...
- 数据库字典 - 微擎开发文档
数据库字典 - 微擎开发文档 参考文档 account 平台账号表(公众号.小程序.PC等) 字段名 数据类型 说明 acid int(10) 主键 uniacid int(10) 所属帐号uniac ...
- tx2 fpga pcie无法读写_Cyclone V SOC(ARM+FPGA)开发文档_之开发流程详解
双击可查看大图(手动狗头) 目录 Altera Cyclone V soc开发文档 之软硬件开发 1 Cyclone V开发流程介绍 5 专业术语 5 Cyclone V软件开发介绍 6 U-BOOT ...
- ubuntu arm qt_Cyclone V SOC(ARM+FPGA)开发文档_之开发流程详解
双击可查看大图(手动狗头) 目录 Altera Cyclone V soc开发文档 之软硬件开发 1 Cyclone V开发流程介绍 5 专业术语 5 Cyclone V软件开发介绍 6 U-BOOT ...
- 银联商务全名移动支开发文档_移动商务
银联商务全名移动支开发文档 移动商务 (Mobile Commerce) Mobile Commerce (M-commerce, MC) is a special form of electroni ...
- python 微服务框架 知乎_序: 我需要一个什么样的微服务框架
前言 新坑第一篇文章, 做一个开篇的序吧. 开发了很多 python 的 web 微服务, 也使用过很多 web 框架, django, tornado, flask, 等等等等. 不同的 web 框 ...
最新文章
- 为什么说一知半解的人生最可怕?
- carthage update --no-use-binaries --platform mac,ios
- alpine linux 简介(面向安全应用的发行版)apk
- Linux内核探讨-- 第七章
- 在showModalDialog和showModelessDialog中提交form时不弹出新窗口
- oracle怎么判断是裸设备安装,Oracle 9i下以裸设备方式安装数据库
- 给中国学生的第五封信 – 你有选择的权利
- php导出页面居中设置,PHPExcel导出插入图片和居中问题
- 计算机专业论文docx,计算机系毕业论文范文-20210606000812.docx-原创力文档
- 第二十六讲:tapestry的树状(tree)组件
- 16、React系列之 React 路由
- fiddler打开后 浏览器就上不了网的解决方法
- 如何实现一个遵从设计原则的积分兑换系统2
- mapper mysl实现批量插入 更新
- 宾馆管理系统java外文文献_javaEE酒店管理系统论文+任务书+设计源码+答辩PPT
- Flask 个人网站重构上线
- 【放马过来---谈禅修打坐】
- 运营到底是做什么的?
- Hash算法及常见碰撞解决方法
- css外联式6,css样式内联式,外联式,嵌入式的格式是什么?
热门文章
- swoole安装异步reids
- ubuntu之路——day8.1 深度学习优化算法之mini-batch梯度下降法
- [SCOI2005]王室联邦
- LeetCode 35.搜索插入位置
- linux下find命令的使用和总结
- 用JavaScript和CSS实现“在页面中水平和垂直居中”的时钟
- gcc 从5.3升级到6.1之后 openwrt pkg-config glib编译报错修复办法
- Docker - Install docker on CentOS
- Myeclipse的workspace配置文件浅谈
- pytorch学习——torch.cat和torch.stack的区别