夺命雷公狗---微信开发23----客服消息接口基础和推送文本

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了夺命雷公狗---微信开发23----客服消息接口基础和推送文本相关的知识,希望对你有一定的参考价值。

我们这边课程里面一共用到了三个文件,分别是WeChat.class.php和common.php以及index.php

我们在写这个功能之前也要学会查手册,手册我们可以在微信开发这里找到,如下所示:

技术分享

 

点击进去后我们将会看到客服接口,我们可以点击下进去看看里面有什么动动

 

技术分享

 

这里有一个发送文本消息的,我们点击进去看下

 

技术分享

 

这里很明显就看到文本消息是通过一个json数据来进行实现的,废话不多说,开工

这里我们先来写一个WeChat.php的文件,这里作用主要适用于封装一个CURL上传类的,代码如下所示:

<?php
    class WeChat{
        //我把请求内容封装到类里面
        protected function http_request($url, $data=null){
            //我们使用curl函数
            //初始化
            $ch = curl_init();
            //设置变量
            curl_setopt($ch, CURLOPT_URL,$url); //这意思是,设置好发送的url地址发送到那
            //curl_setopt($ch, CURLOPT_SSL_VERIFYPEER,$url); 这样的意思是对方要不要验证,如果不用则按照下面的即可
            curl_setopt($ch, CURLOPT_SSL_VERIFYPEER,FALSE); //如果不用验证,这样即可
            curl_setopt($ch, CURLOPT_SSL_VERIFYHOST,FALSE); //如果不用验证HOST主机这样即可
            if(!empty($data)){
                curl_setopt($ch,CURLOPT_POST,1);//启用时会发送一个常规的POST请求,就像表单提交的一样。
                curl_setopt($ch,CURLOPT_POSTFIELDS,$data);//全部数据使用HTTP协议中的"POST"操作来
            }
            curl_setopt($ch, CURLOPT_RETURNTRANSFER,1); //将curl_exec()获取的信息以文件流的形式返回,而不是直接输出
            //执行
            $output = curl_exec($ch); //返回来的值是一个json格式的值
            //关闭句柄
            curl_close($ch);
            return $output;
        }
    }

 

 

这里封装好了,那么下一步就开始写一个common.php的文件了,这里主要是用来存放回复信息的模版的,代码如下所示:

 

<?php
    $tmp_arr = array(
    ‘text‘ => <<<XML
<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[%s]]></Content>
<FuncFlag>0</FuncFlag>
</xml>
XML
,
    ‘image‘=> <<<XML
<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[image]]></MsgType>
<Image>
<MediaId><![CDATA[%s]]></MediaId>
</Image>
</xml>
XML
,
    ‘voice‘=> <<<XML
<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<Voice>
<MediaId><![CDATA[%s]]></MediaId>
</Voice>
</xml>
XML
,
    ‘music‘=> <<<XML
<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>
</Music>
</xml>
XML
,
    ‘singlenews‘=> <<<XML
<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<ArticleCount>1</ArticleCount>
<Articles>
<item>
<Title><![CDATA[%s]]></Title> 
<Description><![CDATA[%s]]></Description>
<PicUrl><![CDATA[%s]]></PicUrl>
<Url><![CDATA[%s]]></Url>
</item>
</Articles>
</xml> 
XML
,
    ‘newses‘=> <<<XML
<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[news]]></MsgType>
<ArticleCount>4</ArticleCount>
<Articles>
<item>
<Title><![CDATA[%s]]></Title> 
<Description><![CDATA[%s]]></Description>
<PicUrl><![CDATA[%s]]></PicUrl>
<Url><![CDATA[%s]]></Url>
</item>
<item>
<Title><![CDATA[%s]]></Title> 
<Description><![CDATA[%s]]></Description>
<PicUrl><![CDATA[%s]]></PicUrl>
<Url><![CDATA[%s]]></Url>
</item>
<item>
<Title><![CDATA[%s]]></Title> 
<Description><![CDATA[%s]]></Description>
<PicUrl><![CDATA[%s]]></PicUrl>
<Url><![CDATA[%s]]></Url>
</item>
<item>
<Title><![CDATA[%s]]></Title> 
<Description><![CDATA[%s]]></Description>
<PicUrl><![CDATA[%s]]></PicUrl>
<Url><![CDATA[%s]]></Url>
</item>
</Articles>
</xml> 
XML
,
    ‘video‘=> <<<XML
<xml>
<ToUserName><![CDATA[%s]]></ToUserName>
<FromUserName><![CDATA[%s]]></FromUserName>
<CreateTime>%s</CreateTime>
<MsgType><![CDATA[video]]></MsgType>
<Video>
<MediaId><![CDATA[%s]]></MediaId>
<Title><![CDATA[%s]]></Title>
<Description><![CDATA[%s]]></Description>
</Video> 
</xml>
XML
);

 

 

我们最后一步就要开始写index.php的代码了,这里是这里是这篇课程的核心代码

 

<?php
/**
  * wechat php test
  */

//define your token
require_once "common.php";
//这里是引入curl发送函数的类
require_once ‘WeChat.class.php‘;
define("TOKEN", "twgdh");

//这里让这个类继承了curl发送参数的类
class wechatCallbackapiTest extends WeChat
{
    public function valid()
    {
        $echoStr = $_GET["echostr"];

        //valid signature , option
        if($this->checkSignature()){
            echo $echoStr;
            exit;
        }
    }

    public function responseMsg()
    {
        //get post data, May be due to the different environments
        $postStr = $GLOBALS["HTTP_RAW_POST_DATA"];
        
          //extract post data
        if (!empty($postStr)){
                /* libxml_disable_entity_loader is to prevent XML eXternal Entity Injection,
                   the best way is to check the validity of xml by yourself */
                // 使用simplexml技术对xml进行解析 
                // libxml_disable_entity_loader(true), 是从安全性考虑,为了防止xml外部注入,
                //只对xml内部实体内容进行解析
                libxml_disable_entity_loader(true);
                //加载 postStr 字符串
                  $postObj = simplexml_load_string($postStr, ‘SimpleXMLElement‘, LIBXML_NOCDATA);
                file_put_contents(‘abc.log‘, "\r\n\r\n". $postStr, FILE_APPEND);
                $fromUsername = $postObj->FromUserName;
                file_put_contents(‘abc.log‘, "\r\n\r\n". $fromUsername, FILE_APPEND);
                $toUsername = $postObj->ToUserName;
                file_put_contents(‘abc.log‘, "\r\n\r\n". $toUsername, FILE_APPEND);
                $keyword = trim($postObj->Content);
                $time = time();
                global $tmp_arr;
                //根据接收到的消息类型,来进行分支处理(switch)
                switch($postObj->MsgType)
                {
                    case ‘event‘:
                        if($postObj->Event == ‘subscribe‘)
                        {
                            
                            $contentStr = "欢迎关注leigood微信测试号噢";
                            $resultStr = sprintf($tmp_arr[‘text‘], $fromUsername, $toUsername, $time, $contentStr);
                            echo $resultStr; 
                        }
                        
                        //响应用户的点击事件
                        if($postObj->Event == ‘CLICK‘){
                            if($postObj->EventKey == ‘V1001_TODAY_MUSIC‘){ //自定义菜单里面有很多个,这里key是自定义的
                                //这里主要写自己想要的业务逻辑
                                $contentStr = "夺命雷公狗欢迎您来到编程世界";
                                $resultStr = sprintf($tmp_arr[‘text‘], $fromUsername, $toUsername, $time, $contentStr);
                                echo $resultStr; 
                            }
                        }
                        
                        break;
                    case ‘text‘: //回复文本模块
                        //这里开始测试客服消息接口了
                        if($keyword == ‘文本‘){
                           //获取token
                           require ‘get_token.php‘;
                           $contentStr = ‘这是客服接口的回复,我们可以帮助您什么?‘;
                           //对发送的内容进行urlencode编码,防止中文乱码
                           $contentStr = urlencode($contentStr);
                           //到时候我们我发送的内容我们放到一个数组里面去了
                           $content_arr = array(‘content‘=>"{$contentStr}");
                           //这里的意思是将来我要发送消息给这个用户
                           $reply_arr = array(‘touser‘=>"{$fromUsername}",‘msgtype‘=>‘text‘,‘text‘=>$content_arr);
                           //下一步就是将编码转成规定的json格式
                           $post = json_encode($reply_arr);
                           //url解码,如果不解码他将会发来一段二进制代码
                           $post = urldecode($post);
                           $url = "https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token={$access_token}";
                           //这里我们来使用类的继承机制,来简化代码
                           $this -> http_request($url,$post);
                           //这里是可以回复多条消息的,只需要在执行下这个函数即可
                           //$this -> http_request($url,$post);
                           
                        }else{
                            $contentStr = ‘您输入的格式有误‘;
                            $resultStr = sprintf($tmp_arr[‘text‘], $fromUsername, $toUsername, $time, $contentStr);
                            echo $resultStr;
                        }
                        break;
                    case ‘image‘: //处理用户上传图片
                        $media_id = $postObj -> MediaId; //获取到用户上传的图片的mediaid
                        $resultStr = sprintf($tmp_arr[‘image‘], $fromUsername, $toUsername, $time, $media_id);
                        echo $resultStr;
                        
                        //将图片保存到本地服务器的文件系统
                        //1.先给图片创建一个名字
                        $image_file_name = time().‘.jpg‘;
                        //2.获取该图片的内容
                        $image_file = file_get_contents($postObj->PicUrl);
                        //3.保存到本地服务器的文件系统
                        //提醒:一定要保证您创建的文件夹是www用户可读可写,否则无法保存该图片到文件夹下
                        file_put_contents("./uploadimage/".$image_file_name,$image_file);
                        
                        //将图片的路径和相关信息入库
                        //1.创建一张表
                        //2.链接mysql数据库,并且添加图片信息
                        $connect = mysql_connect(‘localhost‘,‘root‘,‘root‘);
                        mysql_select_db(‘wxdb‘,$connect);
                        mysql_query(‘set names utf8‘);
                        $media_path = "./uploadimage/".$image_file_name; //路径
                        $sql = "insert into keep_image_uploads (id,openid,media_id,media_path) values(NULL,‘{$fromUsername}‘,‘{$media_id}‘,‘{$media_path}‘)";
                        mysql_query($sql,$connect);
                        break;
                    case ‘voice‘: //处理用户上传语言的业务逻辑
                        $media_id = $postObj -> MediaId; //获取media_id的id号
                        $resultStr = sprintf($tmp_arr[‘voice‘], $fromUsername, $toUsername, $time, $media_id);
                        echo $resultStr;
                        break;
                    case ‘location‘: //处理用户上传的地理位置信息
                        $Location_X = $postObj -> Location_X; //获取上传地理位置的纬度
                        $Location_Y = $postObj -> Location_Y; //获取上传地地理位置经度
                        $contentStr = "您上报的地理位置是:\n经度是:{$Location_Y} \n纬度是: {$Location_X}";
                        $resultStr = sprintf($tmp_arr[‘text‘], $fromUsername, $toUsername, $time, $contentStr);
                        echo $resultStr;
                        break;
                    case ‘link‘: //接收并回复链接信息
                        //获取到用户上传的链接信息
                        $Title = $postObj -> Title;
                        $Url = $postObj -> Url;
                        $contentStr = "<a href=‘{$Url}‘>{$Title}</a>";
                        $resultStr = sprintf($tmp_arr[‘text‘], $fromUsername, $toUsername, $time, $contentStr);
                        echo $resultStr;
                        break;
                        
                }
        }else {
            echo "";
            exit;
        }
    }
        
    private function checkSignature()
    {
        // you must define TOKEN by yourself
        if (!defined("TOKEN")) {
            throw new Exception(‘TOKEN is not defined!‘);
        }
        
        $signature = $_GET["signature"];
        $timestamp = $_GET["timestamp"];
        $nonce = $_GET["nonce"];
                
        $token = TOKEN;
        $tmpArr = array($token, $timestamp, $nonce);
        // use SORT_STRING rule
        sort($tmpArr, SORT_STRING);
        $tmpStr = implode( $tmpArr );
        $tmpStr = sha1( $tmpStr );
        
        if( $tmpStr == $signature ){
            return true;
        }else{
            return false;
        }
    }
}

//如果这段代码放在上面,那程序将会报错,因为继承的问题,会显示类没有找到
$wechatObj = new wechatCallbackapiTest();
//当接入成功后,请注销这句话,否则,会反复验证。
//$wechatObj->valid();
//添加响应请求的语句
$wechatObj->responseMsg();

?>

核心代码就这段:

技术分享

 

 

这里如果还怕代码有误,可以直接对她进行访问,看下有么语法之类的错误

以上是关于夺命雷公狗---微信开发23----客服消息接口基础和推送文本的主要内容,如果未能解决你的问题,请参考以下文章

夺命雷公狗---微信开发27----客服消息接口基础和推送图文消息

夺命雷公狗---微信开发26----客服消息接口基础和推送视频

夺命雷公狗---微信开发31----微信群发消息4

夺命雷公狗---微信开发30----微信群发消息3

夺命雷公狗---微信开发11----接收并回复链接消息

夺命雷公狗---微信开发09----玩转单图文消息回复