微信小程序登录换取token的教程

程序员文章站 2024-01-01 18:42:46

前言：这次主要是介绍些业务逻辑，技术点倒是没有多少。不过在开发中，优秀的编程思路同样是非常值得学习的。最近小程序可以说在开发届狠狠的火了一把。微信小程序可以开发...

前言：

这次主要是介绍些业务逻辑，技术点倒是没有多少。不过在开发中，优秀的编程思路同样是非常值得学习的。

最近小程序可以说在开发届狠狠的火了一把。微信小程序可以开发游戏，腾讯率先带头，做出了一个跳一跳也是点爆朋友圈。所谓落后就要挨打，那么今天就开始学习小程序的一些小知识吧（本文基于十年磨一剑的tp5)

目录：

微信登录换取token的流程
如何将code变成openid和session_key
抛出错误异常和派发令牌

一：微信登录换取token的流程

多说无益，直接上图

微信小程序登录换取token的教程

小程序获取token.png

这里介绍的主要是后端开发的流程，前端的不是本文介绍的重点

二：如何将code变成openid和session_key

我们后端开发人员对这个业务是从接受code开始的，由客户端发来一个code码。

我们接受后先进行验证

  //创建独立验证器，调用验证器中的验证方法
tokencheck::instance()->gocheck();

如果不是很清楚验证器的用法的朋友可以先看看我之前写的

验证规则很简单，就是判断不为空就可以了

下一步就是我们需要把code换取openid 和session_key了

首先我们需要在创建一个service层的类，（为什么要使用service层呢？主要是我为了让模型层粒度细一些。业务比较复杂的就放在service层。这样比较利于后期修改和升级）

class usertoken extends token
{
  protected $wxappid;
  protected $wxappsecret;
  protected $wxloginurl;

  //构造函数中赋值成员变量
  public function __construct($code)
  {
    $this->wxappid = config('wx.app_id');
    $this->wxappsecret = config('wx.app_secret');
    $this->wxloginurl = sprintf(config('wx.login_url'), $this->wxappid, $this->wxappsecret, $code);
  }
}

写一个构造函数，让在对象生成的时候就赋值成员变量方便使用，这里的appid和appsecret 都是在微信申请小程序的时候就有了的。这里就不介绍了。之前我是把他们全部存在我的配置文件的。使用tp5提供的config函数将他们提出来。最后使用 sprintf方法，将这些参数拼接到wxloginurl中，方便我们访问。

熟悉oauth2.0的朋友都知道，拿到这个url其实就是微信的一个接口，我们去换取授权。

下面我们创建一个getusertoken方法

  /**
   * 获取用户的令牌方法
   * @throws exception
   */
  public function getusertoken()
  {
    //调用公共函数中的http方法(也就是curl的方法,我也是在网上抄的。存放在common.php中就可以直接用了）
    $result = http($this->wxloginurl, 'post');
    //判断连接是否成功
    if ($result[0] == 200) {
      //将返回的json处理成数组
      $wxresult = json_decode($result[1], true);
      //判空
      if (empty($wxresult)) {
        throw new exception('获取session_key,openid时异常，微信内部错误');
      } else {
         //判断返回的结果中是否有错误码
        if (isset($wxresult['errcode'])) {
          //如果有错误码，调用抛出错误方法
          $this->_throwwxerror($wxresult);
        } else {
          //没有错误码，调用私有的派发token方法
          $token = $this->_granttoken($wxresult);
          return $token;
        }
      }
    } else {
      throw new exception('连接微信服务器失败');
    }
  }

写好了，方法之后，只需要在控制器中调用这个getusertoken方法就可以了。

大家可能会问，那个_throwwxerror和_granttoken方法是干什么的？

可能大家也看出来了，这个getusertoken方法中我们一个获取到了微信返回的结果，也就是$wxresult变量中的数据。如果不出别的意外那么，里面就有我们需要的openid和session_key。这不过，介绍到这里，我们还没有开始使用他们

三：抛出错误异常和派发令牌

这里两个其实就是两个方法，重点是派发令牌。这里的抛出异常。我准备单独写一次介绍。

  /**
   * 微信获取open_id失败，抛出异常方法
   * @param $wxresult
   * @throws wxexception
   */
  private function _throwwxerror($wxresult)
  {
    throw new wxexception(
      [
        'message' => $wxresult['errmsg'],
        'errorcode' => $wxresult['errcode']
      ]
    );
  }

我们来看_granttoken方法

我们将微信返回给我们的数据，转换为数组后，保存到$wxresult中，在调用派发令牌方法时，直接传入。

下面的代码中有个user类调用的getuidbyopenid方法，这里是user模型上封装的一个查询方法，就是看user表中是否有这个openid，如果有返回uid

如果数据库中没有uid的话，说明是新用户，则在数据库中插入一条数据，返回新插入的主键 id

/**
   * 派发user 令牌
   * @param $wxresult
   * @return string
   * @throws exception
   */
  private function _granttoken($wxresult)
  {
    //拿到open_id
    $openid = $wxresult['openid'];
    //判断open_id是否存在
    $id = user::getuidbyopenid($openid);
    //如果数据库中不存在
    if (!$id) {
      //添加一条记录,返回新创建的id
      $id = user::createuser($openid);
      if (!$id) {
        throw new exception('新增一条user失败');
      }
    }
    //拼接数据为一个数组。（这个方法就是将wxresult中的openid和session_key取出，然后和用户id一起放进一个数组）
    $tokenvalue = $this->_splicingvalue($wxresult, $id);
    //制作令牌
    //存入缓存
    $token = $this->_savecache($tokenvalue);
    //返回token
    return $token;
  }

下面我们来看看_savecache方法

我们将拼接成一个数组的数据$tokenvalue直接传入方法中,调用一个随机字符串方法，将这个随机字符串当做key，把传入我用户数据序列化之后当作value，然后根据配置里的缓存过期时间，来存入缓存。

  /**
   * 将令牌存入缓存,返回token
   * @param $tokenvalue
   * @return string
   * @throws tokenexception
   */
  private function _savecache($tokenvalue)
  {
    //调用父类中的随机字符串方法
    $key = parent::_maketoken();
    //序列化包含id,openid,sessionkey的数组
    $value = serialize($tokenvalue);
    //在配置中取出保存时间的配置
    $expriestime = config('setting.expires_in');
    //存入缓存
    $result = cache($key, $value, $expriestime);
    //如果存入失败，抛出异常
    if (!$result) {
      throw new tokenexception(
        ['errorcode' => 10003, 'message' => 'token save fail']
      );
    }
    //返回随机字符串（也就是要返回给客户端的token)
    return $key;
  }

随机字符方法，为了提高token的安全性，让别人不那么容易的复制我们的token。我就写了这样的一个方法，大家如果有安全性更好的方法也可以使用自己想的。我就不介绍了看代码吧

 /**
   * 构建token随机字符串
   */
  public function _maketoken()
  {
    //随机抽取32位字符串方法，保存在common.php中
    $randchar = randomkeys(32);
    //时间戳
    $timestamp = time();
    //配置中的盐值
    $salt = config('secret.token_salt');
    //拼接之后sha1加密
    return sha1($randchar . $timestamp . $salt);
  }

这里我们就将随机生成的随机字符串返回到service层，service层再返回给控制器，控制器就可以返回给客户端了

看下完整的控制器吧

  public function gettoken($code = '')
  {
    //创建独立验证器，调用验证器中的验证方法
    tokencheck::instance()->gocheck();
    $utobj = new usertoken($code);
    $token = $utobj->getusertoken();
    return ['token'=>$token];
  }

这样一个小程序登录换取token的流程就走完了。这个业务呢是借助微信服务器中的openid来作为唯一标识来派发token，如果不是微信的项目的话，我们同样的可以是微博登录，qq登录等第三方登录。或者自己的数据库中的id来作为唯一标识。同样可以派发token。

这里只是介绍了token的派发，还有一些token的应用，有时间的时候再写吧。今天就介绍到这里。如果有什么没有写对的地方，希望大神指正，我们共同学习。

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

微信小程序登录换取token的教程