微信公众平台----带参数二维码生成和扫描事件

摘要: 账号管理----生成带参数的二维码 消息管理----接收消息----接收事件推送

为了满足用户渠道推广分析和用户帐号绑定等场景的需要，公众平台提供了生成带参数二维码的接口。使用该接口可以获得多个带不同场景值的二维码，用户扫描后，公众号可以接收到事件推送。

目前有2种类型的二维码：

1、临时二维码，是有过期时间的，最长可以设置为在二维码生成后的30天（即2592000秒）后过期，但能够生成较多数量。临时二维码主要用于帐号绑定等不要求二维码永久保存的业务场景。
2、永久二维码，是无过期时间的，但数量较少（目前为最多10万个）。永久二维码主要用于适用于帐号绑定、用户来源统计等场景。

获取带参数的二维码的过程包括两步，首先创建二维码ticket，然后凭借ticket到指定URL换取二维码。

创建二维码ticket

每次创建二维码ticket需要提供一个开发者自行设定的参数（scene_id），分别介绍临时二维码和永久二维码的创建二维码ticket过程。

临时二维码请求说明：

http请求方式: POST
URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKENPOST数据格式：json
POST数据例子：{"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}

永久二维码请求说明：

http请求方式: POST
URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKENPOST数据格式：json
POST数据例子：{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}
或者也可以使用以下POST数据创建字符串形式的二维码参数：
{"action_name": "QR_LIMIT_STR_SCENE", "action_info": {"scene": {"scene_str": "123"}}}

    参数说明：

     

    返回参数说明：

        永久二维码只返回ticket和url，临时二维码只返回ticket，expire_seconds和url

      

通过ticket换取二维码

        获取二维码ticket后，开发者可用ticket换取二维码图片。请注意，本接口无须登录态即可调用。

        请求说明

HTTP GET请求（请使用https协议）https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET提醒：TICKET记得进行UrlEncode

        返回说明

  ticket正确情况下，http 返回码是200，是一张图片，可以直接展示或者下载。

  错误情况下（如ticket非法）返回HTTP错误码404。

        示例代码： 

$vipLogic = D('Vip','Logic');
            $userinfo = session('userinfo');
            $vip = $vipLogic->where(array('openid'=>$userinfo['openid']))->field('sceneid,id')->find();
            
            $count = $vipLogic->where(array('sceneid'=>array('neq',0)))->count();
            $sceneid = $count+1;    //设定场景值
            
            if($vip != null && $vip['sceneid'] == 0){    //用户关注了该公众号 但是还未生成自己的二维码
                $data = array(                //需要POST传输的数据
                    'action_name'        => 'QR_LIMIT_SCENE',
                    'action_info'        => array(
                        'scene'    => array(
                            'scene_id'    => $sceneid,
                        ),
                    ),
                );
                    
                $dir = './Public/Wechat/qrcode/'.$userinfo['openid'].'.jpg'; //二维码存放路径
                    
            
                if(!file_exists($dir)){
                    //二维码不存在  则生成二维码
                    $ticket = $this -> getTicket($data);
                    $vipLogic -> where(array('openid'=>$userinfo['openid'])) -> save(array('sceneid'=>$sceneid));
            
                    $url = 'https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket='.$ticket['ticket'];  //通过ticket换取二维码
                    $img = file_get_contents($url);
                        
                    $dir = './Public/Wechat/qrcode/'.$userinfo['openid'].'.jpg';
                        
                    if(!empty($img)){
                        @file_put_contents($dir,$img);
                    }
                }
            }
            
            
            
            
public function getTicket($data){
        $access_token = $this -> getAccessToken();
        $url = 'https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token='.$access_token;    
        $res = $this -> httpdata($url, $data);
        return $res;    
    }
    
/**
    * http带参数请求
    * @date: 2015-1-31
    * @author: 明
    * @return:
    */
    public function httpdata($url,$data){
        $data = json_encode($data);
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
        curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
        curl_setopt($ch, CURLOPT_USERAGENT, 'Mozilla/5.0 (compatible; MSIE 5.01; Windows NT 5.0)');
        curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
        curl_setopt($ch, CURLOPT_AUTOREFERER, 1);
        curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        $status = curl_exec($ch);
        curl_close($ch);
        $res = json_decode($status,true);
        return $res;
    }

扫描带参数二维码事件

用户扫描带场景值二维码时，可能推送以下两种事件：

1. 如果用户还未关注公众号，则用户可以关注公众号，关注后微信会将带场景值关注事件推送给开发者。

2. 如果用户已经关注公众号，在用户扫描后会自动进入会话，微信也会将带场景值扫描事件推送给开发者。

1. 用户未关注时，进行关注后的事件推送

参数说明：

2. 用户已关注时的事件推送

    参数说明：

示例代码：在获取关注事件加入功能代码

$key = explode('_', $eventkey) ;
        if($key[1]!=null){
            //邀请我的人
            $vipLogic = D('Vip','Logic');
            $vip = $vipLogic->where(array('sceneid'=>$key[1]))->field('id,openid')->find();
            
            //我
            $openid = session('openid');    
        }