应用场景:公众号推广时,用户通过扫码关注公众号,需要统计用户是通过谁的二维码进行关注。
思路:在用户扫码关注公众号时,二维码带上推广者的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; } }