详解php微信开发带参数二维码的使用说明

最近做微信PC端网页微信相关功能的开发，从一个新手的角度来说，微信公众号的文档还是不好理解的，网上找的帖子大都也都基本上是复制微信公众平台上给的文档，开发微信带参数二维码过程中还是遇到不少坑的，在此把我的开发过程比较详细的记录下，希望对大家有所帮助。

我本次开发使用的是认证服务号。

1 接入
首先进入微信公众号 -> 基本配置
下面是基本配置的页面，在URL中填写服务器地址，这个地址就是接受微信推送事件的一个接口，我是使用thinkPHP框架开发的程序，在其中一个Module（Decoration）的Action目录下新建一个类，比如叫： WechatAction.class.php ，在该Action中新建一个public方法，比如叫： URLRedirect() ，那么在这个URL中填写的就是 http://[IP]:[port]/index.php/Decoration/Wechat/UrlRedirect ,然后填写Token，Token随意填，EncodingAESKey要不要都行，然后点击确认，微信会往这个URL上发送一个get请求，里面包含很多参数，其中大部分都是让我们自己核对这次访问是不是微信服务器请求的，我自己没有验证，他的要求是如果我们核对成功，即原样返回get请求中的一个参数echostr，这里的返回不是return，也不是ajaxReturn，而使用echo，如果用thinkPHP开发的话，直接使用 echo I('echostr'); 即可。然后接口即验证成功了。

2 带参数二维码的作用
微信的带参数二维码有两种，一种是临时二维码，一种是永久二维码，但是永久二维码的生成是有个数限制的，我这次要实现的功能是用户未登录的情况下在网站上使用产品，比如获得某商品的详细报价，但是又不想注册，然而又想保存这个报价单，这个时候网页可以生成一张二维码，用户只要用微信扫一扫这个二维码，官方公众号就会给这个用户发送一天图文消息，图文消息点开后就是用户刚刚获得的报价单，而且可以随时点击查看并且分享给朋友进行比价。所以临时二维码即可正常使用。
上面是我是怎么使用的，下面介绍一下整个交互的流程：

当用户扫描这个二维码，如果用户关注了公众号，用户会直接进入与公众号的会话页面，微信服务器会给我们在上一步设置的服务器URL中推送一条消息，其中可以携带一个我们自定义的参数。如果用户未关注公众号，则用户首先会跳转到公众号关注页面，用户点击关注后，会直接进入公众号的会话页面，微信服务器这时也会给我们设置的URL推送一个事件消息，携带我们自定义参数，我们可以根据这个参数和事件类型做控制下一步动作。

3 具体开发过程

3.1 获取access_token
这个access_token是我们程序调用微信接口的凭证，目前的有效期是7200秒，所以我们需要定时更新access_token。
获得方法：
方法 ： GET
url ：https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
其中的参数APPID和APPSECRET是我们公众号的APPID和APPSECRET，在微信公众号 -> 基本配置中可以查到，调用成功会返回如下JSON数据：
{"access_token":"ACCESS_TOKEN","expires_in":7200}

其中access_token就是调用接口凭证，expire_in是token有效时间。
我本人是把access_token存在数据库中，同时保存过期时间，然后封装公用函数 getWechatAccessToken() ，每次先检查access_token是否过期，如果过期则重新获取，否则直接使用数据库保存的access_token即可，我忘了在哪儿看加过，这个access_token每天的获取次数应该是有限制的。下面是 getWechatAccessToken() 的具体实现：

//获取access_token
function getWechatAccessToken(){
 $wechatInfo = M('wechat_info')->select();
 $wechatInfo = array_reduce($wechatInfo, create_function('$result, $v', '$result[$v["conf_name"]] = $v;return $result;'));
 $expireTime = $wechatInfo['PUBLIC_WECHAT_ACCESSTOKEN_EXPIRES']['conf_value'];        //前面不用管，是我数据库相应设置

 if (time() < $expireTime){    //access_token未过期
  return $wechatInfo['PUBLIC_WECHAT_ACCESSTOKEN']['conf_value'];
 }else{         //access_token过期，重新获取
  $baseUrl = C('WECHAT_PUBLIC_GET_ACCESS_TOKEN');
  $url = str_replace("##APPSECRET##", $wechatInfo['PUBLIC_WECHAT_APPSECRET']['conf_value'], str_replace("##APPID##", $wechatInfo['PUBLIC_WECHAT_APPID']['conf_value'], $baseUrl));
  $result = file_get_contents($url);
  $result = json_decode($result, true);

  if (array_key_exists('errorcode', $result)){  //失败重试一次
   return false;
  }else{
   M('wechat_info')->where(array('conf_name' => 'PUBLIC_WECHAT_ACCESSTOKEN'))->save(array('conf_value' => $result['access_token']));
   M('wechat_info')->where(array('conf_name' => 'PUBLIC_WECHAT_ACCESSTOKEN_EXPIRES'))->save(array('conf_value' => time()+$result['expires_in']-200));
   return $result['access_token'];
  }
 }
}

C('WECHAT_PUBLIC_GET_ACCESS_TOKEN') = https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

封装好这个之后，我们每次就可以安心的使用了。

.2 创建临时二维码

3.2.1 获取ticket3

请求方式： POST
接口：https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
POST数据： {"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}
接口URL中的TOKEN即我们在3.1中获取的access_token，post数据中expire_seconds是二维码的有效时间，最多为30天，action_name临时二维码的话固定就是QR_SCENE，scene_id即我们自定义参数，是个32位非0整数，我在应用中把它设为订单的ID，微信服务器推送事件的时候会把这个值返回给我们设置的接口中，然后我会根据这个值去拿相应的订单数据展示在网页上，这是后话。

下面是封装的生成临时二维码的方法：

//创建临时二维码
function getTemporaryQrcode($orderId){
 $accessToken = getWechatAccessToken();
 $url = str_replace("##TOKEN##", $accessToken, C('WECHAT_PUBLIC_GET_TEMPORARY_TICKET'));
 $qrcode = '{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": '.$orderId.'}}}';
 $result = api_notice_increment($url, $qrcode);
 $result = json_decode($result, true);
 return urldecode($result['url']);
}

其中的方法 api_notice_increment() 是我封装的一个POST方法函数，我试过很多POST的方法，可能由于微信接口对POST方法和参数的限制比较严格，这个浪费了好久时间，最后在网上找到了一个可以使用的封装好的POST方法，建议大家先自己试试，如果微信返回错误吗，就用这个吧，起码我测试微信这个接口的时候用postman测试返回的都是错误，而且一定要用JSON字符串，一定要是非常严格的JSON字符串。下面是这个方法：

function api_notice_increment($url, $data){
 $ch = curl_init();
 $header = "Accept-Charset: utf-8";
 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_HTTPHEADER, $header);
 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);
 $tmpInfo = curl_exec($ch);
 if (curl_errno($ch)) {
  curl_close( $ch );
  return $ch;