PHP开发微信公众号（二）消息接受与推送

上一篇文章我们知道怎么获取二维码，这样别人就可以扫描二维码来关注我们，但是别人关注后，发送消息，我们怎么进行相关处理？

这里我们就来学习下怎么处理处理这些消息，以及推送消息。

学习之前首先你需要有一个域名和空间

url：填写你希望微信公众平台把用户的消息转发到哪里

token：随便输入，用于微信公众平台和你的站点进行第一次通信建立关联用

/*
    用于第一次验证我们网站url合法性
     */
    public function firstValid(){
        //检验签名的合法性
        if($this->_checkSignature()){
            //签名合法，告知微信公众平台服务器
            echo $_GET['echostr'];
        }
    }
/**
     * 验证签名
     * @return bool
     */
    private function _checkSignature(){
        //获得由微信公众平台请求的验证数据
        $signature = $_GET['signature'];
        $timestamp = $_GET['timestamp'];
        $nonce = $_GET['nonce'];
        //将时间戳，随机字符串，token按照字母顺序排序，病并连接
        $tmp_arr = array($this->_token,$timestamp,$nonce);
        sort($tmp_arr,SORT_STRING);//字典顺序
        $tmp_str = implode($tmp_arr);//连接
        $tmp_str = sha1($tmp_str);//sha1加密
        if($signature==$tmp_str){
            return true;
        }else{
            return false;
        }
    

在你的站点写一个脚本，调用一下firstValid 就可以完成微信公众平台和你站点的关联。$this->_token，就是你上面写token。

然后再提交，就能成功了。

1、关注后，欢迎语的设置

有人关注后，微信公众平台会给我们发一个xml格式的数据，如下：

然后我们对这个信息进行获取，转化成我们想要的格式，进行相关判断，返回数据，同样也需要组装成xml格式

public function responseMsg(){
        /*
        获得请求时POST:XML字符串
        不能用$_POST获取，因为没有key
         */
        $xml_str = $GLOBALS['HTTP_RAW_POST_DATA'];
        if(empty($xml_str)){
            die('');
        }
        if(!empty($xml_str)){
            // 解析该xml字符串，利用simpleXML
            libxml_disable_entity_loader(true);
            //禁止xml实体解析，防止xml注入
              $request_xml = simplexml_load_string($xml_str, 'SimpleXMLElement', LIBXML_NOCDATA);
            //判断该消息的类型，通过元素MsgType
            switch ($request_xml->MsgType){
                case 'event':
                    //判断具体的时间类型（关注、取消、点击）
                    $event = $request_xml->Event;
                      if ($event=='subscribe') { // 关注事件
                          $this->_doSubscribe($request_xml);
                      }elseif ($event=='CLICK') {//菜单点击事件
                          $this->_doClick($request_xml);
                      }elseif ($event=='VIEW') {//连接跳转事件
                          $this->_doView($request_xml);
                      }else{

                      }
                    break;
                case 'text'://文本消息
                    $this->_doText($request_xml);
                    break;
                case 'image'://图片消息
                    $this->_doImage($request_xml);
                    break;
                case 'voice'://语音消息
                    $this->_doVoice($request_xml);
                    break;
                case 'video'://视频消息
                    $this->_doVideo($request_xml);
                    break;
                case 'shortvideo'://短视频消息
                    $this->_doShortvideo($request_xml);
                    break;
                case 'location'://位置消息
                    $this->_doLocation($request_xml);
                    break;
                case 'link'://链接消息
                    $this->_doLink($request_xml);
                    break;
            }
        }
    }

我们可以给用户回复文字，图片，视频，音乐，新闻等等，首先定义好相应的回复模块

private $_msg_template = array(
        'text' => '<xml><ToUserName><![CDATA[%s]]></ToUserName><FromUserName><![CDATA[%s]]></FromUserName><CreateTime>%s</CreateTime><MsgType><![CDATA[text]]></MsgType><Content><![CDATA[%s]]></Content></xml>',//文本回复XML模板
        'image' => '<xml><ToUserName><![CDATA[%s]]></ToUserName><FromUserName><![CDATA[%s]]></FromUserName><CreateTime>%s</CreateTime><MsgType><![CDATA[image]]></MsgType><Image><MediaId><![CDATA[%s]]></MediaId></Image></xml>',//图片回复XML模板
        'music' => '<xml><ToUserName><![CDATA[%s]]></ToUserName><FromUserName><![CDATA[%s]]></FromUserName><CreateTime>%s</CreateTime><MsgType><![CDATA[music]]></MsgType><Music><Title><![CDATA[%s]]></Title><Description><![CDATA[%s]]></Description><MusicUrl><![CDATA[%s]]></MusicUrl><HQMusicUrl><![CDATA[%s]]></HQMusicUrl><ThumbMediaId><![CDATA[%s]]></ThumbMediaId></Music></xml>',//音乐模板
        'news' => '<xml><ToUserName><![CDATA[%s]]></ToUserName><FromUserName><![CDATA[%s]]></FromUserName><CreateTime>%s</CreateTime><MsgType><![CDATA[news]]></MsgType><ArticleCount>%s</ArticleCount><Articles>%s</Articles></xml>',// 新闻主体
        'news_item' => '<item><Title><![CDATA[%s]]></Title><Description><![CDATA[%s]]></Description><PicUrl><![CDATA[%s]]></PicUrl><Url><![CDATA[%s]]></Url></item>',//某个新闻模板
    );

%s就代表我们需要填的参数，后面用spritf统一传入

首先我们回复一句‘你好’；

/**
     * 发送文本信息
     * @param  [type] $to      目标用户ID
     * @param  [type] $from    来源用户ID
     * @param  [type] $content 内容
     * @return [type]          [description]
     */
    private function _msgText($to, $from, $content) {
        $response = sprintf($this->_msg_template['text'], $to, $from, time(), $content);
        die($response);
    }
//关注后做的事件
private function _doSubscribe($request_xml){
        //处理该关注事件，向用户发送关注信息
        $content = '你好';
        $this->_msgText($request_xml->FromUserName, $request_xml->ToUserName, $content);
    }

这样，用户一关注就会收到‘你好’。

2、发送图片

微信中的图片、语音、视频、缩略图统称素材，发送和接受都是以media_id进行的。

简单说：用给公众号一张图片，这张图片会上传到微信公众平台服务器，然后生成一个唯一的media_id,然后返回一个xml信息给我们，其中就有media_id。而我们要发给用户图片，也需要先把图片上传给公众平台，然后获取到media_id，根据这个media_id结合图片回复模板返回给平台

<xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[image]]></MsgType>
 <PicUrl><![CDATA[this is a url]]></PicUrl>
 <MediaId><![CDATA[media_id]]></MediaId>
 <MsgId>1234567890123456</MsgId>
 </xml>

* 上传临时素材（永久素材也可以）：图片,语音，视频，缩略图
* 储存到微信公众平台服务器，3天
* 可通过上传后返回的media_id再次去取得该图片
自己定义上传函数

public function uplodeTmp($file,$type){
        $url='https://api.weixin.qq.com/cgi-bin/media/upload?access_token='.$this->getAccessToken().'&type='.$type;
        $data = array(
            'media' => '@'.$file,
            );
        $result = $this->_request('post',$url,$data);
        $result_obj = json_decode($result);
        return $result_obj;
    }

自己调用该函数上传站点图片，通过返回结果获得该图片media_id

发送给用户：

//发送图片
    private function _msgImage($to,$from,$file,$is_id=false){
        //判断是不是media_id
        if($is_id){
            $media_id=$file;
        }else{
            // 上传图片到微信公众服务器，获取mediaID
            $result_obj = $this->uploadTmp($file, 'image');
            $media_id = $result_obj->media_id;
        }
            //拼凑xml图片发给微信平台，然后平台返回图片给用户
            $response = sprintf($this->_msg_template['image'],$to,$from,time(),$media_id);
            die($response);
    }

这样用户就可以获得你的图片。

返回缩略图，语音、视频、短视频也是用同样的方法

如果我们希望用户发出‘图片’两个字时，返回给他一张图片，该怎么做？

private function _doText($request_xml){
    //接受文本信息
    $content = $request_xml->Content;
    if('图片' == $content){
            $imgMediaId = 'UD-4n5YeK6NXhPCOYT_eV4YxYNZqCILemIZuZR3GYmj_AtrqhnHiIUUOQHSi71Ew';
            $this->_msgImage($request_xml->FromUserName, $request_xml->ToUserName,$imgMediaId,true);
        }

    }

当然我们这里把图片写死了，实际可根据具体业务逻辑进行改变，改变media_id就行了。

3、发送音乐

如果用户输入音乐，我们发一首歌给他，音乐跟其他的几个素材不太一样

 private function _doText($request_xml){
         //接受文本信息
         $content = $request_xml->Content;

         if('音乐' == $content){
             $music_url='音乐网络地址链接';
             $ha_music_url='音乐网络地址链接';
             $thumb_media_id='一张图片的media_id';
             $title = '音乐名称';
             $desc = '音乐描述';
             $this->_msgMusic($request_xml->FromUserName, $request_xml->ToUserName, $music_url, $hq_music_url, $thumb_media_id, $title, $desc);
         }
 }
 //发送音乐
     private function _msgMusic($to, $from, $music_url, $hq_music_url, $thumb_media_id, $title='', $desc='') {
         $response = sprintf($this->_msg_template['music'], $to, $from, time(), $title, $desc, $music_url, $hq_music_url, $thumb_media_id);
         die($response);
     }

4、图灵机器人的接入

图灵官网注册申请appkey

 //图灵机器人接入         

 $content = $request_xml->Content;

$url = 'http://www.tuling123.com/openapi/api?key='.$this->_appkey.'&info='.$content.'&userid='.$request_xml->FromUserName;
            // $data['key'] = $this->_appkey;//
            // $data['info'] = $content;//用户输入的内容
            // $data['userid'] = $request_xml->FromUserName;
            $response_content = json_decode($this->_request('get',$url,array(),false));
            //$response_content->code决定返回的是什么
            //100000  文本 text
            //200000 链接  text+url
            //302000   新闻 text +list(新闻列表，里面有：article,source,icon,detailurl)分别是标题、来源、图片、详情地址
            //308000   菜谱  text+name+info+detailurl+icon
            $this->_msgText($request_xml->FromUserName, $request_xml->ToUserName, $response_content->text);

可以自行根据图灵官网反回的code进行分类判断，字符组装，再回复给用户。

这样，你的公众号就变成了一个图灵机器人了。

5、发送图文（新闻）

我一般看到的微信公众号都是以图文信息进行推送消息，这个新闻类型怎么发送？

if('新闻' == $content){
            $item_list = array(
                array('title'=>'标题','desc'=>'描述','picurl'=>'图片地址','url'=>'该文章的地址'),
                array('title'=>'标题','desc'=>'描述','picurl'=>'图片地址','url'=>'该文章的地址')
                );
            $this->_msgNews($request_xml->FromUserName,$request_xml->ToUserName,$item_list);
        }

//发送新闻
    private function _msgNews($to,$from,$item_list=array()){
        //拼凑文章部分
        $item_str = '';
        foreach ($item_list as $item) {
            $item_str .= sprintf($this->_msg_template['news_item'],$item['title'],$item['desc'],$item['picurl'],$item['url']);
        }
        //拼凑主体部分
        $response = sprintf($this->_msg_template['news'], $to, $from, time(), count($item_list), $item_str);
        die($response);
    }

6、菜单创建删除

一般公众号底部都有1-3个菜单选项，选项里可能还有子菜单，这个如何通过php代码进行创建？

菜单创建和删除都是针对所有的，不能单独操作某一个菜单

//菜单删除
    public function menuDelete(){
        $url ='https://api.weixin.qq.com/cgi-bin/menu/delete?access_token=' . $this->getAccessToken();
        $result = $this->_request('get',$url);
        $result_obj = json_decode($result);
        if($result_obj->errcode == 0){
            return true;
        }else{
            return false;
        }
    }

删除很简单，调用这个函数就删除所有菜单了，不过已关注的用户需要24小时后才会生效。

//创建菜单
    public function menuSet($menu) {
        $url = 'https://api.weixin.qq.com/cgi-bin/menu/create?access_token=' . $this->getAccessToken();
        $data = $menu;
        $result_obj = json_decode($this->_request('post',$url, $data));
        if ($result_obj->errcode == 0) {
            return true;
        } else {
            echo $result_obj->errmsg, '<br>';
            return false;
        }
    }

创建菜单需要我们传一个json格式参数，同一样已关注的用户也会24小时后生效

1、自定义菜单最多包括3个一级菜单，每个一级菜单最多包含5个二级菜单。
2、一级菜单最多4个汉字，二级菜单最多7个汉字，多出来的部分将会以“...”代替。

各参数的类型，以及作用，请到开发者文档查看：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421141013

json数据格式如下:创建了3个主菜单，以及对应的子菜单。

$menu = <<<JSON
{
    "button": [
        {
            "name": "扫码",
            "sub_button": [
                {
                    "type": "scancode_waitmsg",
                    "name": "扫码带提示",
                    "key": "scancode_waitmsg",
                    "sub_button": [ ]
                },
                {
                    "type": "scancode_push",
                    "name": "扫码推事件",
                    "key": "scancode_push",
                    "sub_button": [ ]
                }
            ]
        },
        {
            "name": "发图",
            "sub_button": [
                {
                    "type": "pic_sysphoto",
                    "name": "系统拍照发图",
                    "key": "pic_sysphoto",
                   "sub_button": [ ]
                 },
                {
                    "type": "pic_photo_or_album",
                    "name": "拍照或者相册发图",
                    "key": "pic_photo_or_album",
                    "sub_button": [ ]
                },
                {
                    "type": "pic_weixin",
                    "name": "微信相册发图",
                    "key": "pic_weixin",
                    "sub_button": [ ]
                }
            ]
        },
        {
            "name": "快捷操作",
            "sub_button" : [
                {
                    "name": "地理位置",
                    "type": "location_select",
                    "key": "location_select"
                },
                {
                    "name": "普通点击",
                    "type": "click",
                    "key": "click"
                },
                {
                    "name": "查看URL",
                    "type": "view",
                    "url" : "http://www.soso.com/"
                },
            ]
        },
    ]
}
JSON;

源码下载：https://github.com/Ivanlovening/wechat