微信公众平台使用说明

微信公众平台使用说明

微信公众平台是通过公众号为用户提供服务的平台

用户OpenID :每关注一个公众号就会生成一个OpenID

用户UnionID: 多个公众号可以绑到一个开放平台账号下（同主体），每个用户对同一个开放平台下的多个公众号都只有一个UnionID

微信公众平台是为公众号进行服务的，

微信公众平台调用每个接口都是基于 access_token的，有效期2个小时，每天次数有限

公众号主要通过 消息会话 和 网页 来为用户提供服务的

消息会话：

    群发消息

    被动回复消息：要加密

    客服消息

    模板消息

网页：

    网页授权获取用户基本信息

    微信JS-SDK: 可以在网页上录制和播放语音、上传照片和拍照等

接口使用说明：

第三方平台代公众号调用接口：

授权成功后，可以使用authorizer_access_token作为凭证，调用方式和公众号使用自身API的方式一样（只是需将调用API时提供的公众号自身access_token参数，替换为authorizer_access_token）

目的：给你一个公众号，能自定义菜单，能收发消息

前期准备：

一个公众号：https://mp.weixin.qq.com

微信公众平台 -> 开发->基本配置 ->公众号开发信息 ：

开发者appid  

开发者appsecret

IP白名单

如果没有将公众号授权给第三方平台的话，就要开启->服务器配置：

           服务器地址URL：这个地址是收发微信服务器消息的

           令牌Token：这个自定义，要与代码验证中的一致

           消息加解密EncodingAESKey: 这个也是自定义

令牌Token的检测代码：

当你写好代码后，配置好服务器后点击提交的时候，微信服务器会向公众号的服务器url发送可以用$_GET 接收的参数，其中有一项是：$_GET['echostr']，验证代码如下：

if(isset($_GET['echostr'])){
    // 这里要先进行公众平台的服务器配置
    $signature = $_GET["signature"];
    $timestamp = $_GET["timestamp"];
    $nonce = $_GET["nonce"];
    $token = "zhaizhishe";
    $tmpArr = array($token, $timestamp, $nonce);
    sort($tmpArr);
    $tmpStr = implode( $tmpArr );
    $tmpStr = sha1( $tmpStr );

    if( $tmpStr == $signature ){

header('content-type:text');
ob_clean();
        echo  $_GET['echostr'];
    }else{

echo "fail";

            }
}

验证代码可以自行百度：https://blog.csdn.net/fkedwgwy/article/details/80356660

如果提交成功，这个服务器url就可以收发信息了

微信token验证失败原因及解决方案 ：

https://blog.csdn.net/sinat_22878395/article/details/69258165

如果粉丝给公众号发消息，

实际上是 粉丝-->微信服务器-（消息体是xml形式）-->公众号服务器

所以微信服务器给公众号发来xml形式的消息体，公众号就要进行处理

类似这样的：

<xml><ToUserName><![CDATA[gh_612e2d3e001d]]></ToUserName>
<FromUserName><![CDATA[oqz7p0RcdvSUwUl95JWosYKhEQj8]]></FromUserName>
<CreateTime>1534125513</CreateTime>
<MsgType><![CDATA[text]]></MsgType>
<Content><![CDATA[52]]></Content>
<MsgId>6589018907673136305</MsgId>
</xml>

这个xml字符串 直接用 file_get_contents("php://input") 来接收;

消息类型有：文本 、图片、语音、视频、小视频、地理位置、链接、事件

每个消息类型的xml格式都有所区别，但是都有一个MsgType，具体类型可以通过该字段来判断；事件可以通过MsgType = event来判断，具体什么事件可以通过Event来判断，有些还得通过EventKey进一步判断

回复消息的时候，也要根据消息类型的模板来，如果公众号想给粉丝回复图片消息，就需用到图片类型的xml格式；

这里的$postStr就是file_get_contents("php://input")赋值的

if (!empty($postStr)){
    $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
    switch($postObj->MsgType){
        case "event":
            $this->_doEvent($postObj);
            break;
        case "text":
            $this->_doText($postObj);
            break;
        case "image":
            $this->_doImage($postObj);
            break;
        case "voice":
            $this->_doVoice($postObj);
            break;
        case "video":
            $this->_doVideo($postObj);
            break;
        case "shortvideo":
            $this->_doShortvideo($postObj);
            break;
        case "location":
            $this->_doLocation($postObj);
            break;
        case "link":
            $this->_doLink($postObj);
            break;
        default:
            $this->_doText($postObj);
            break;

    }
}

附上模板：

 $template = [
    'text' => "<xml>
        <ToUserName><![CDATA[%s]]></ToUserName>
        <FromUserName><![CDATA[%s]]></FromUserName>
        <CreateTime>%s</CreateTime>
        <MsgType><![CDATA[%s]]></MsgType>
        <Content><![CDATA[%s]]></Content>
        </xml>",
    'image' =>"<xml>
        <ToUserName><![CDATA[%s]]></ToUserName>
        <FromUserName><![CDATA[%s]]></FromUserName>
        <CreateTime>%s</CreateTime>
        <MsgType><![CDATA[%s]]></MsgType>
        <Image><MediaId><![CDATA[%s]]></MediaId></Image></xml>",
    'article'=>'<xml>
        <ToUserName><![CDATA[%s]]></ToUserName>
        <FromUserName><![CDATA[%s]]></FromUserName>
        <CreateTime>%s</CreateTime>
        <MsgType><![CDATA[news]]></MsgType>
        <ArticleCount>%s</ArticleCount>
        <Articles>%s</Articles>
        </xml>',
    'article_blade'=>' <item>
        <Title><![CDATA[%s]]></Title>
        <Description><![CDATA[%s]]></Description>
        <PicUrl><![CDATA[%s]]></PicUrl>
        <Url><![CDATA[%s]]></Url>
        </item>'
];

这里是处理事件的方法：

public function _doEvent($postObj){
    if ($postObj->Event == 'subscribe') { // 关注事件
        $contentStr = "我知道你会来的，你到底还是来了";
        $resultStr = sprintf($this->template['text'], $postObj->FromUserName, $postObj->ToUserName,time(), "text", $contentStr);
        echo $resultStr;

    } elseif ($postObj->Event == 'CLICK') {//菜单点击事件
        if($postObj->EventKey == "about_us"){
            $picUrl1 ="http://mmbiz.qpic.cn/mmbiz_jpg/90z7NBNDibEtcicTNDMuMtTk3JA78jHZdoM47F91c5m9zfNic2U3U4hrP6TcZ4GTG0EWV3bKsiaLRuhRE50VwfgH7g/0?wx_fmt=jpeg";//这是引用的图片地址
            $picUrl2='http://mmbiz.qpic.cn/mmbiz_png/90z7NBNDibEtcicTNDMuMtTk3JA78jHZdoUbWcIllAibib4RibCnpicoKzbE2WqNVLN0XDQp7uQiajSK7oEmuRNibBGLfQ/0?wx_fmt=png';
            $picUrl3='http://mmbiz.qpic.cn/mmbiz_jpg/90z7NBNDibEtcicTNDMuMtTk3JA78jHZdo3mf2MfibyXzbCnVibI95J7FtiaRPSlyvkxMzddWNibh7XfQBzWzDHSZIlQ/0?wx_fmt=jpeg';
            $url="http://www.guigu.org/wap.php?action=article&id=120111";
            $url2 = "http://www.zhaizhishe.com/";
            $url3 ="https://www.zhipin.com/gongsi/119e4beb5ff768881nx509W6EQ~~.html";
            $item_list = array(
                array('title'=>'益帮手','desc'=>'点击图片查看','picurl'=>$picUrl1,'url'=>$url),
                array('title'=>'宅职社','desc'=>'这里有你需要的','picurl'=>$picUrl2,'url'=>$url2),
                array('title'=>'加入我们吧，有你更精彩喔','desc'=>'技术宅','picurl'=>$picUrl3,'url'=>$url3),
            );

            //拼凑文章部分
            $item_str = '';
            foreach ($item_list as $item) {
                $item_str .= sprintf($this->template['article_blade'],$item['title'],$item['desc'],$item['picurl'],$item['url']);
            }
            //拼凑主体部分
            $response = sprintf($this->template['article'], $postObj->FromUserName,$postObj->ToUserName, time(), count($item_list), $item_str);
            echo $response;
        }
        if($postObj->EventKey == "public_account"){

            $resultStr = sprintf($this->template['image'], $postObj->FromUserName, $postObj->ToUserName,time(), "image","eEs3ScKeaId4eLAkfLaKWWbfbypcdL6oAB3DLfl3cQg");
            echo $resultStr;

        }
    } elseif ($postObj->Event == 'VIEW') {//连接跳转事件
        $contentStr = "你做了跳转操作";
        $resultStr = sprintf($this->template['text'], $postObj->FromUserName, $postObj->ToUserName,time(), "text", $contentStr);
        echo $resultStr;
    }
}

 

上面Event == “CLICK”或者 “VIEW”是基于 自定义菜单事件的

其中view是点击菜单跳转链接的，view对应的一定是url

然后click是点击菜单拉取消息的，click对应的是一定是自定的eventKey值

附上自定义菜单方法：

 public function createMenu(){

       // 这里要特别注意：
       // view 对应的是url
       // click 对应的是 key
       $data ='{
    "button":[

  {
              "type":"view",
              "name":"官网",
              "url":"http://www.zhaizhishe.com/"
     },

     {
          "name":"宅职社",
          "sub_button":[
           {
              "type":"click",
              "name":"公众号",
              "key":"public_account"
           },
           {
              "type":"click",
              "name":"关于我",
              "key":"about_us"

           },
           {
              "type":"view",
              "name":"加入我",
              "url":"https://www.zhipin.com/gongsi/119e4beb5ff768881nx509W6EQ~~.html"
           }]
      },

    {
          "name":"益帮手",
          "sub_button":[
           {
              "type":"click",
              "name":"小程序",
              "key":"mini"
           },
           {
              "type":"view",
              "name":"智慧水站",
              "url":"http://www.guigu.org/wap.php?action=article&id=120111"
           }
          ]
       }
   ]
}';


       $url = "https://api.weixin.qq.com/cgi-bin/menu/create?access_token=".$this->access_token;
       $content_send_code = request_curl($url,$https=false,$method='post',$data,$json=true);
       $content_send_code = json_decode($content_send_code,True);
       var_dump($content_send_code);
       return $content_send_code;
       /*
        * array(2) {
                 ["errcode"]=>
                 int(0)
                 ["errmsg"]=>
                 string(2) "ok"
               }

        * */

   }

如果要给粉丝回复图片消息的时候，前提是素材库里面要先有图片

首先要先新增其他类型的永久素材，返回media_id 和url

然后新增永久素材，这里的post参数有一个thumb_media_id必须等于上一个方法返回的merdia_id

/**
 * 新增永久素材
 * @return mixed
 */
public function createMaterial(){
    $file = "F:\hxx\pic\04.jpg";
    $thumb_media_id = $this->uplodeForever($file);
    $data = '
                {
                        "articles": [{
                        "title": "my_img_01",
                        "thumb_media_id":"'.$thumb_media_id['media_id'].'",
                        "author": "xiaoxian",
                        "digest": "",
                        "show_cover_pic": 1,
                        "content": "this is my content",
                        "content_source_url":"http://www.zhaizhishe.com"
                        },]
                }
            ';

    $url = "https://api.weixin.qq.com/cgi-bin/material/add_news?access_token=".$this->access_token;
    $content_send_code = request_curl($url,$https=true,$method='post',$data,$json=true);
    $content_send_code = json_decode($content_send_code,True);
    var_dump($content_send_code);
    return $content_send_code;


}

/**
 * 新增其他类型永久素材，返回media_id和 url
 * @param $file
 * @return mixed
 */
public function uplodeForever($file){
    $url='https://api.weixin.qq.com/cgi-bin/material/add_material?access_token='.$this->access_token.'&type=image';
    $data = array(
        'media' => new CURLFile($file),
    );
    // 这个方法里的 $josn= false,因为没有用Json格式的数据, $https = true;
    $content = request_curl($url,$https=true,$method='post',$data,$json=false);
    $content = json_decode($content,True); //转数组
    if(!empty($content['errcode'])){
        die("media_id获取失败，错误编码:".$content['errcode']."错误信息：".$content['errmsg']);
    }
   var_dump($content);
    return $content;
    /*
     * $content = [
     *
     *          ["media_id"]=>"Zsy4YtKwjDza2KjxV9sk5OcMrictB0DxUcot8koydcfWpH8MMesC3W2W8QHCM6Jx"
     *           ["url"]=>""
     * ];*/
}