Laravel + Vue.js 的 SPA 项目中进行微信网页授权的一种姿势

相信 Laravel 和 Vue.js 很多人都已经相当熟悉了，在较近版本的 Laravel 中，已经默认支持 Vue 组件化开发，这也顺应了眼下基于 API 前后分离以及开发单页面应用（SPA）的均势。

项目基本情况

• Laravel 5.4

• overtrue/laravel-wechat 包 （内部依赖 overtrue/wechat)

• vue.js 2.x

• vue-router (非必须)

• vue-axios (非必须)

解决步骤

1. 安装 laravel-wechat

使用 composer 安装好 laravel-wechat 包并做好相关配置，具体如下：

• 在 configapp.php 中的 providers 数组下加入下面两行

Overtrue\LaravelWechat\ServiceProvider::class,
Overtrue\LaravelSocialite\ServiceProvider::class,

• 在 appHttpKernel.php 中的 $routeMilleware 下加入

'wechat.oauth' => \Overtrue\LaravelWechat\Middleware\OAuthAuthenticate::class,

其它一些微信公众号相关的参数配置请参考 EasyWechat 官方文档

1. 添加路由

在 routesweb.php 中新增一条路由如下：

Route::get('/mobile', 'MobileController@index')->middleware('wechat:oauth');

注意该路由使用了 oauth:wechat 中间件，这个中间件将实现网页授权逻辑。

1. 创建控制器及声明方法

创建一个控制器 MobileController，并在其中声明如下方法：

public function index()
{
    // 拿到授权微信用户资料
    $wechatUser = session('wechat.oauth_user');

    return response()->view('mobile')->cookie('openid', $wechatUser->id ?? null);
}

这一方法将会在 http 响应中带上一个含有 openid 值的 Cookie，需要注意的是，这个 Cookie 是加密了的，所以不用担心安全性方面的问题。如果不想加密，可以在 EncryptCookies 中间件里进行配置。

此外，除了直接使用 openid 之外，也可以使用其它值，甚至根据 openid 查到你本地数据库中的用户数据，进而在 Cookie 中传 user_id。具体用法依个人喜好和需求而定。

响应头中加入 Cookie 也是所有步骤中的关键所在，有了这个 Cookie，后续前端页面向服务器发起请求时会自动带上这个 Cookie。

1. 添加模板以及 Vue 组件，这个可以参照 Laravel 默认的 welcome.blade.php 模板以及 App.vue 组件调整得到。(注意模板文档名，按前面示例，应该改成 mobile.blade.php)

2. 定义 API 路由及对应的控制器，在前端页面里根据需要向服务器发起请求。具体怎么发就得看用的什么插件了，比如我用的 axios，事件就很简单

axios.get(url).then(response => {
  console.log(response.data)
}).catch(error => {
  console.log(error)
})

1. 最后，在 API 控制器里，可以取到当前授权的微信用户 openid

// 请求头里的 openid
$openid = Crypt::decrypt(\Request::cookie('openid'));

这里使用 Crypt::decrypt() 方法进行解密，如果没加密，可不使用。

总结

由可可见，在 SPA 项目里完成网页授权也十分容易，当然，这也部分归功于安正超（overtrue)的 laravel-wechat 包。

因为不同于传统的 Laravel 项目，前后分离的 SPA 项目前后端以 API 作为纽带，而在这些 API 相关的控制器里，无法再随意使用服务器会话，所以这里使用 http cookie 作为替代，实际上网页授权逻辑，在进入 SPA 页面 Vue 根实例创建之前就已经完成了,算是一种变通吧，至于这个姿势科学、优雅与否，我也不太好说，但至少目前为止自己的几个项目中使用一切正常……