ThinkPHP3.2完全开发手册

ThinkPHP系列开发手册在线版

Wechat

该接口主要处理微信服务器推送到用户服务器的数据,并提供自动回复数据的封装接口。

该接口对应的文件为Com/Wechat.class.php, 主要用户接收微信推送过来的用户数据并自动回复。

注意:识别和分析用户发送的内容,并提供回复内容需要开发者更具实际情况自己实现,本接口值提供获取用户数据和自动回复方法。

执行流程

  1. 实例化WeChat类,并传入在微信后台填写的token $wechat = new Wechat($token);
  2. 接收微信服务器推送的数据 $data = $wechat->request();
  3. 分析数据,决定要做出什么样的回复 (由开发者自己实现)
  4. 回复消息 $wechat->response($content, $type);

注意:在微信后台填写 TOKEN 和 URL 时验证Token的逻辑已经在Wechat类里面实现,你完全不需要考虑认证的情况。只需要保证微信服务器能正常访问到你所提供的URL,且该 URL对应的Controller里实例化了 Wechat 类就可以了。

示例代码

$token = ''; //微信后台填写的TOKEN
/* 加载微信SDK */
$wechat = new Wechat($token);
/* 获取请求信息 */
$data = $wechat->request();
if($data && is_array($data)){
    //在这里你可以分析用户发送过来的数据来决定需要做出什么样的回复
    $content = ''; //回复内容,回复不同类型消息,内容的格式有所不同
    $type    = ''; //回复消息的类型
    /* 响应当前请求(自动回复) */
    $wechat->response($content, $type);
}

接收到的消息类型

接受到的信息类型有9种,分别使用下面九个常量标识

  • Wechat::MSG_TYPE_TEXT //文本消息
  • Wechat::MSG_TYPE_IMAGE //图片消息
  • Wechat::MSG_TYPE_VOICE //音频消息
  • Wechat::MSG_TYPE_VIDEO //视频消息
  • Wechat::MSG_TYPE_MUSIC //音乐消息
  • Wechat::MSG_TYPE_NEWS //图文消息(推送过来的应该不存在这种类型,但是可以给用户回复该类型消息)
  • Wechat::MSG_TYPE_LOCATION //位置消息
  • Wechat::MSG_TYPE_LINK //连接消息
  • Wechat::MSG_TYPE_EVENT //事件消息

事件消息又分为下面五种

  • Wechat::MSG_EVENT_SUBSCRIBE //订阅
  • Wechat::MSG_EVENT_SCAN //二维码扫描
  • Wechat::MSG_EVENT_LOCATION //报告位置
  • Wechat::MSG_EVENT_CLICK //菜单点击
  • Wechat::MSG_EVENT_MASSSENDJOBFINISH //群发消息成功

自动回复消息

识别用户发送的消息,通过相关程序处理后,决定要给用户回复什么样的数据,可以调用 $wechat->response($content, $type); 进行回复。 其中,$content为回复的内容,$type为回复的消息类型。不同类型的消息,$content的数据结构有所不同。

文本消息:

//当回复文本消息时$content为字符串
$content='回复的文本消息';

图片消息:

//当回复图片消息时$content为图片ID
//图片ID是通过 WechatAuth 的 mediaUpload 接口上传的图片ID
$content=$midea_id;

音频消息:

//当回复音频消息时$content为音频ID
//音频ID是通过 WechatAuth 的 mediaUpload 接口上传的音频ID
$content=$midea_id;

视频消息:

//当回复视频消息时$content为一维数组
//array($media_id, $title, $description)

//$media_id    WechatAuth 的 mediaUpload 接口上传的视频ID
//$title       视频标题
//$description 视频说明

$content=array($media_id, $title, $description);

音乐消息:

//当回复音乐消息时$content为一维数组
//array($title, $description, $musicurl, $hqmusicurl, $thumb_media_id)

//$title          //音乐名称
//$description    //音乐说明
//$musicurl       //普通音质 mp3 url
//$hqmusicurl     //高品质 mp3 url
//$thumb_media_id //缩略图ID

$content=array($title, $description, $musicurl, $hqmusicurl, $thumb_media_id);

图文消息:

//当回复图文消息时$content为二维数组
//array($news, $news1, $news2, ..., $news9); 
//注意:微信规定,一条消息最多只能发送10条图文信息

//每条消息的结构如下
//$news=array($title, $description, $url, $thumb_media_id);

//$title          //新闻标题
//$description    //新闻简介
//$url            //新闻原文URL
//$thumb_media_id //缩略图ID

$content=array(
    array($title, $description, $url, $thumb_media_id),
    array($title1, $description1, $url1, $thumb_media_id1),
    array($title2, $description2, $url2, $thumb_media_id2),
    ...
    array($title9, $description9, $url9, $thumb_media_id9),
);