微信带场景参数的二维码生成与使用

应用场景:公众号推广时,用户通过扫码关注公众号,需要统计用户是通过谁的二维码进行关注。
思路:在用户扫码关注公众号时,二维码带上推广者的id,在关注公众号后,获取到该推广者的id。

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

这里我们选择永久二维码来实现功能。
首先我们先创建并获取到带有推广者id的二维码。

1.创建二维码ticket,每次创建二维码ticket需要提供一个开发者自行设定的参数(scene_id),这个scene_id也就是推广者的id

永久二维码请求说明
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”: “test”}}}

因为我们带的是推广者的id,所以我们选用前面一种带整型的参数。
参数说明 :
action_name :二维码类型,QR_LIMIT_SCENE为永久的整型参数值
action_info 二维码详细信息
scene_id 场景值ID,临时二维码时为32位非0整型,永久二维码时最大值为100000(目前参数只支持1–100000)

1.1 通过AppID以及AppSecret获取access_token

public function access_token() {
        try{
            $token = Db::name('access_token')->where('id',2)->find();
            if ($token['time']<time()) {
                $url    = 'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=wxf9f65c0fd755d6db&secret=9b62ba0fcb44143f0111b58fa02e813e';
                $token  = curl1('get', $url);
                $token  = json_decode($token, true);
                Db::name('access_token')->where('id',2)->update([
                    'token' => $token['access_token'],
                    'time'  => bcadd(time(), 7200)
                ]);
            }else{
                $token  = $token['token'];
            }
            return $token;
        }catch (\Exception $e){
            echo $e->getMessage();
        }
    }

根据access_token请求链接获取ticket,这里scene_id为整数,scene_str为字符串,  可根据实际情况改变

/**
     * 生成二维码所需要的ticket
     * 2021/5/22 13:47
     */
    public function get_ticket() {
        $token = $this->access_token();
        $state = time().$this->two_letter(11);
        $url = 'https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token='.$token;
        $data['data'] = json_encode([
            'expire_seconds'    => 60,
            'action_name'       => 'QR_LIMIT_STR_SCENE',
            'action_info'       => [
                'scene'     =>  [
                    'scene_str' => $state
                ]
            ]
        ]);
        $ticket = curl1('post', $url, $data);
        $ticket = json_decode($ticket, true);
        return json_encode(['ticket'=>$ticket['ticket'], 'state'=>$state]);
    }

2.通过ticket换取二维码
请求说明:
HTTP GET请求(请使用https协议)https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET
上面获取二维码的操作并不复杂,大部分开发者都是卡在如何获取参数scene_id的值这个问题上面。

首先,我们要知道 用户扫描带场景值二维码时,可能推送以下两种事件:
如果用户还未关注公众号,则用户可以关注公众号,关注后微信会将带场景值关注事件推送给开发者。
如果用户已经关注公众号,在用户扫描后会自动进入会话,微信也会将带场景值扫描事件推送给开发者。

这些所谓的事件推送给开发者其实就是返回一个xml数据包给开发者,所以现在最大的问题就是如何接收到这个xml数据包。

我们登录微信公众平台,开发- - 基本配置
微信带场景参数的二维码生成与使用

 

 

从这里我们可以知道,开发者需要的事件推送将会被转发到我们设置的服务器地址中。

接下来我们就要修改服务器配置,在修改服务器配置时可能会遇到token验证失败。
原因可能是还没有在该服务器地址指向的文件中进行验证。
我们创建相应服务器地址指向的文件 , 我这里是 https://www.xxx.com/home/Scancode/check

protected $token = '基本配置分配的token';
    //校验
    public function check() {
        //从GET参数中读取三个字段的值
        $signature = $_GET["signature"];
        $timestamp = $_GET["timestamp"];
        $nonce = $_GET["nonce"];
        //读取预定义的TOKEN
        $token = $this->token;
        //对数组进行排序
        $tmpArr = array($token, $timestamp, $nonce);
        sort($tmpArr, SORT_STRING);
        //对三个字段进行sha1运算
        $tmpStr = implode($tmpArr);
        $tmpStr = sha1($tmpStr);
        //判断我方计算的结果是否和微信端计算的结果相符
        //这样利用只有微信端和我方了解的token作对比,验证访问是否来自微信官方.
        if ($tmpStr == $signature && $_GET["echostr"]) {
            echo $_GET["echostr"];
            exit;
        } else {
            $this->reponseMsg();
        }
    }

    /**
     * 接收推送消息
     * 2021/5/24 15:36
     */
    public function reponseMsg() {
        $redis = new_redis();
        $postStr = file_get_contents('php://input');    //获取到xml数据包
        $postObj = simplexml_load_string($postStr);//转化成对象
        switch ($postObj->MsgType) {
            case 'event':
                //推送事件
                if($postObj->Event == 'subscribe'){
                    //这里是扫描二维码事件
                    //用户未关注的情况
                    $openid = $postObj->FromUserName; //这里是用户的openid
                    $str = $postObj->EventKey;
                    //qrscene_123123   用户未关注的情况下KEY值: qrscene_为前缀,后面为二维码的参数值
                    $arr    = explode('_', $str);
                    $state  = end($arr);     //这里是state, redis的前缀

                    //剩下的代码就省略了, 根据实际需求来实现不同的功能.

                    $redis->set($state, $openid); //我这里是吧openid 存到redis里了
                }else if($postObj->Event == 'SCAN'){
                    //这里是扫描二维码事件
                    //用户关注的情况
                    $openid = $postObj->FromUserName; //这里是用户的openid
                    $state = $postObj->EventKey;   //这里是推广者的id

                    //剩下的代码就省略了, 根据实际需求来实现不同的功能.

                    $redis->set($state, $openid); 
                }
                break;

            default:
                $this->err('推送失败');
                break;
        }
    }

 

上一篇:深入理解脚本化CSS系列第二篇——查询计算样式


下一篇:【带着canvas去流浪(15)】threejs fundamentals翻译系列1-scene graph