Laravel 集成微信用户登录和绑定的实现

最近主要在忙活微信与支付宝平台的对接与开发,本篇就基于后端层面来讲述一下微信的登录与绑定实现。

(一)、申请微信开放平台

最首先的话就是需要去微信开发中心,创建一个账号,然后创建自己的移动或网站应用。

创建完成后,就会需要腾讯的审核,整个过程在1-3天,基本上1天左右就能完成,审核通过如下图所示。

(二) 、封装微信相关接口

微信移动应用开发文档:https://developers.weixin.qq.com/doc/oplatform/mobile_app/wechat_login/authorized_api_call_unionid.html

审核通过后,就需要来封装微信授权、可信息获取的接口。

封装微信授权 && 用户信息获取

微信授权接口:

需要填写的参数如下:

参数	是否必须	说明
appid	是	应用唯一标识，在微信开放平台提交应用审核通过后获得
secret	是	应用密钥 appsecret，在微信开放平台提交应用审核通过后获得
code	是	填写第一步获取的 code 参数
grant_type	是	填 authorization_code

下面通过我们的php代码实现:

<?php
namespace app\helpers;

use guzzlehttp\client;
use illuminate\support\arr;

class wechatapputils
{
  protected $client = null;

  protected $config = [];

  public function __construct()
  {
    $this->config = [
      'wechat_app' => [
        'appid' => env('wechat_appid'),  //审核通过的appid
        'secret' => env('wechat_secret'),  //应用app secret 详情见上图
      ],
      'time_out'  => 5,
    ];
    $this->client = new client([
      'time_out' => $this->config['time_out'],
    ]);
  }

  /**
   * 获取微信用户access_token
   *
   * @param [string] $code
   * @return array
   */
  public function accesstoken($code)
  {
    $accesstokenurl = 'https://api.weixin.qq.com/sns/oauth2/access_token';

    $response = $this->client->request('get', $accesstokenurl, [
      'query' => [
        'grant_type' => 'authorization_code',
        'code'    => $code,
        'appid'   => arr::get($this->config, 'wechat_app.appid'),
        'secret'   => arr::get($this->config, 'wechat_app.secret'),
      ],
    ]);

    $result = $response->getbody()->getcontents();

    return empty($result) ? null : json_decode($result, true);
  }

  /**
   * 微信用户信息
   *
   * @param [string] $accesstoken
   * @param [string] $openid
   * @return array
   */
  public function userinfo($accesstoken, $openid)
  {
    $userinfourl = 'https://api.weixin.qq.com/sns/userinfo';

    $response = $this->client->request('get', $userinfourl, [
      'query' => [
        'access_token' => $accesstoken,
        'openid'    => $openid,
        'lang'     => 'zh_cn',
      ],
    ]);

    $result = $response->getbody()->getcontents();

    return empty($result) ? null : json_decode($result, true);
  }
}

上面的accesstoken方法主要是实现用户授权,效验的code参数是客户端传递过来的,当成功获取收钱用户的授权信息后,可以根据用户的openid来调用userinfo方法查询相关用户的信息,包含了用户的昵称、头像、性别等等。

具体客户端开发文档可以参考这篇:https://developers.weixin.qq.com/doc/oplatform/mobile_app/wechat_login/development_guide.html。

上面的用到的http client是一个第三方拓展包,叫做guzzlehttp,是一个php http客户端，可以轻松发送http请求，并且可以轻松集成web服务。

我们可以通过composer一键安装:

composer require guzzlehttp/guzzle

(三)、完善用户微信授权登录

完成上述的封装操作后,我们便开始讲微信接入到我们自己的系统中与用户进行关联起来,下面是微信接入的一张时序图。

如果用户想使用微信登录,首先会通过客户端唤起微信,请求登录第三方应用,然后微信会询问用户是否成功授权给xx应用,授权成功后,客户端会得到一个授权码:code,然后客户端携带code请求我们的客户端api,进行授权绑定,授权成功后，会得到授权用户openid(应用下的唯一标识),反之抛出异常信息提示用户。

建立oauth表,用于储存用户的授权信息。

建立一张o_auths table 储存用户的授权信息,设计oauth_type字段使其成为一个多态模型,方便接入以后的微博、支付宝、qq接入等等。

schema::create('o_auths', function (blueprint $table) {
  $table->increments('id');
  $table->unsignedinteger('user_id')->index()->comment('用户id');
  $table->morphs('o_auth');
  $table->json('data')->nullable()->comment('授权信息');
  $table->timestamps();
});

完善用户授权绑定

建立好o_auths table,下面开始完善用户授权绑定的逻辑:

function wechat(user $user, $code)
{
  $utils = new wechatapputils;

  //获取微信token
  $accesstokens = $utils->accesstoken($code);
  throw_if(!arr::has($accesstokens, ['unionid', 'openid']), exception::class, '授权失败,请稍后再试!');

  //建立oauth关联
  $oauth = oauth::firstornew(['oauth_type' => 'wechat', 'oauth_id' => $accesstokens['openid']]);
  throw_if(isset($oauth->id),exception::class,'该微信已绑定,请直接登录!');
  $oauth->user_id = $user->id;
  $oauth->data  = arr::only($accesstokens, ['openid', 'refresh_token']);
  $oauth->save();

  return $oauth;
}

首先会通过客户端传递过来的code获取当前用户授权,然后查询该用户是否已授权过,已授权过就提醒用户直接去登录,否则绑定授权信息,返回给客户端。

完善微信登录

完善好用户授权后,登录就显得非常容易了,只需要简单查询授权记录,存在则返回对应绑定的用户,否则抛出异常信息提示用户。

public function signin($user, $code)
{
  $utils = new wechatapputils;
  //获取微信token
  $accesstokens = $utils->accesstoken($code);
  throw_if(!arr::has($accesstokens, ['unionid', 'openid']), exception::class, '授权失败,请稍后再试!');
  $oauth = $this->getuseroauth($user, 'wechat');
  throw_if(is_null($oauth), userexception::class, '授权失败,该账户未绑定!');

  return $oauth;
}

public function getuseroauth(user $user, $oauthtype)
{
  return oauth::where(['oauth_type' => $oauthtype, 'user_id' => $user->id])->first();
}

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