微信开发之微信网页授权 完整示例

作者：dagailv    日期：2018年02月25日 21:51:27    阅读：726

所有微信开发的相关内容，都需要参考官方文档。微信公众平台|开发文档

一、概述

通过网页授权，可以获取用户微信的基本信息。微信网页授权总共分为5个步骤：

1. 用户同意授权，获取code
2. 通过code换取网页授权access_token
3. 刷新access_token（如果需要）
4. 拉取用户信息(需scope为 snsapi_userinfo)
5. 检验授权凭证（access_token）是否有效

二、每一个步骤的实现

步骤1：用户同意授权，获取code

/**
 * 获取code,用于获取openid和access_token
 * @remark
 * code只能使用一次，当获取到之后code失效,再次获取需要重新进入
 * 不会弹出授权页面，适用于关注公众号后自定义菜单跳转等，如果不关注，那么只能获取openid
 */
public function getCode()
{
    if (isset($_GET["code"])) {
        return $_GET["code"];
    } else {
        $str = "location: https://open.weixin.qq.com/connect/oauth2/authorize?appid=" . $this->appid . "&redirect_uri=" . $this->index_url . "&response_type=code&scope=snsapi_userinfo&state=1#wechat_redirect";
        header($str);
        exit;
    }
}

步骤2：通过code换取网页授权access_token

/**
 * 用于获取access_token,返回的$access_token_array中也包含有用户的openid信息。
 */
public function getOpenId()
{
    $access_token_url = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=" . $this->appid . "&secret=" . $this->appsecret . "&code=" . $this->code . "&grant_type=authorization_code";
    $access_token_json = $this->https_request($access_token_url);
    $access_token_array = json_decode($access_token_json, TRUE);
    return $access_token_array;
}

步骤3：刷新access_token（如果需要）

这一步直接略过，实际项目中可根据需要实现。

步骤4：拉取用户信息(需scope为 snsapi_userinfo)

/**
 * 获取到用户的openid之后可以判断用户是否有数据，可以直接跳过获取access_token,也可以继续获取access_token
 */
public function getUserInfo()
{
    $userinfo_url = "https://api.weixin.qq.com/sns/userinfo?access_token=".$this->access_token['access_token'] ."&openid=" . $this->access_token['openid']."&lang=zh_CN";
    $userinfo_json = $this->https_request($userinfo_url);
    $userinfo_array = json_decode($userinfo_json, TRUE);
    return $userinfo_array;
}

三、完整代码（ThinkPHP 3.2.3实现）

<?php

namespace Wechat\Controller;

use Think\Controller;

/**
 * 微信接口基础类，其他微信类都继承这个基础类。
 * 可以自动判断用户状态，获取用户信息。
 */
class WxbaseController extends Controller
{
    public $appid = 'wxba09d9f0fed4b84b';                   //微信APPID，公众平台获取
    public $appsecret = '332c2b1fc1eb282c0136b73723db4237'; //微信APPSECREC，公众平台获取
    public $index_url = "http://www.你的域名.cn/项目目录/index.php?m=分组&c=控制器&a=方法";  //微信回调地址，要跟公众平台的配置域名相同
    public $code;
    public $openid;

    /**
     * 检测有无$_SESSION。如果有，直接忽略。
     * 如果没有$_SESSION，就依次执行getCode、getOpenId、getUserInfo来获取用户信息。
     * 目的是解决CODE只能获取一次，刷新页面openid会丢失的问题。
     * 再判断是否在数据库中，没有则写入数据库。最后将open_id写入session。
     */
    public function _initialize()
    {
        if (!$_SESSION['openid']) {                             //如果$_SESSION中没有openid，说明用户刚刚登陆，就执行getCode、getOpenId、getUserInfo获取他的信息
            $this->code = $this->getCode();
            $this->access_token = $this->getOpenId();
            $userInfo = $this->getUserInfo();
            if ($userInfo) {
                $ins = M('Wechat_user_info');                    //其他框架请自行调整方法。
                $map['openid'] = $userInfo['openid'];
                $result = $ins->where($map)->find();            //根据OPENID查找数据库中是否有这个用户，如果没有就写数据库。继承该类的其他类，用户都写入了数据库中。
                if (!$result) {
                    $ins->add($userInfo);
                }
                session('openid', $userInfo['openid']);         //写到$_SESSION中。微信缓存很坑爹，调试时请及时清除缓存再试。
            }
        }
    }

    /**
     * 获取code,用于获取openid和access_token
     * @remark
     * code只能使用一次，当获取到之后code失效,再次获取需要重新进入
     * 不会弹出授权页面，适用于关注公众号后自定义菜单跳转等，如果不关注，那么只能获取openid
     */
    public function getCode()
    {
        if (isset($_GET["code"])) {
            return $_GET["code"];
        } else {
            $str = "location: https://open.weixin.qq.com/connect/oauth2/authorize?appid=" . $this->appid . "&redirect_uri=" . $this->index_url . "&response_type=code&scope=snsapi_userinfo&state=1#wechat_redirect";
            header($str);
            exit;
        }
    }

    /**
     * 用于获取用户openid
     */
    public function getOpenId()
    {
        $access_token_url = "https://api.weixin.qq.com/sns/oauth2/access_token?appid=" . $this->appid . "&secret=" . $this->appsecret . "&code=" . $this->code . "&grant_type=authorization_code";
        $access_token_json = $this->https_request($access_token_url);
        $access_token_array = json_decode($access_token_json, TRUE);
        return $access_token_array;
    }

    /**
     * 通过code获取用户openid以及用户的微信号信息
     * @return
     * @remark
     * 获取到用户的openid之后可以判断用户是否有数据，可以直接跳过获取access_token,也可以继续获取access_token
     * access_token每日获取次数是有限制的，access_token有时间限制，可以存储到数据库7200s. 7200s后access_token失效
     */
    public function getUserInfo()
    {
        $userinfo_url = "https://api.weixin.qq.com/sns/userinfo?access_token=".$this->access_token['access_token'] ."&openid=" . $this->access_token['openid']."&lang=zh_CN";
        $userinfo_json = $this->https_request($userinfo_url);
        $userinfo_array = json_decode($userinfo_json, TRUE);
        return $userinfo_array;
    }

    /**
     * 发送http请求，并返回数据
     */
    public function https_request($url, $data = null)
    {
        $curl = curl_init();
        curl_setopt($curl, CURLOPT_URL, $url);
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE);
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE);
        if (!empty($data)) {
            curl_setopt($curl, CURLOPT_POST, 1);
            curl_setopt($curl, CURLOPT_POSTFIELDS, $data);
        }
        curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1);
        $output = curl_exec($curl);
        curl_close($curl);
        return $output;
    }
}

四、注意事项

• code只能使用一次，当获取到之后code失效，再次获取需要重新进入授权页面
• access_token每日获取次数有限制，有效期为7200秒，建议缓存到数据库
• 微信缓存比较坑爹，调试时请及时清除缓存再试
• redirect_uri需要URLEncode处理
• 授权回调域名需要与公众平台配置的域名一致

五、相关概念说明

• openid：公众号普通用户的唯一标识，同一用户针对同一公众号的openid是唯一的
• unionid：同一用户在不同公众号下的唯一标识，需要绑定开放平台
• snsapi_base：静默授权，只获取openid，不弹出授权页面
• snsapi_userinfo：弹出授权页面，可获取用户详细信息（昵称、头像等）