jmluang/weapp

weapp login package

laravel-weapp

A weapp login logic Laravel warpper, _(*1)

本仓库从 wafer2开发套件 中提取并封装了微信小程序的登陆逻辑并转移到Laravel中，不仅降低开发者的学习成本，而且能快速完成小程序的登陆功能 甚至连数据库都不需要担心，因为插件已经包装好数据库的操作了。您只需要导入相关的表到数据库中即可。 若需要使用自己的数据库和用户的逻辑操作，只需要继承相应的接口和提供 Facade 类就可以了。详情可以查看使用自己的数据库和逻辑, _(*2)

特点

• 使用了 Guzzlehttp 来发送请求
• 使用了 Laravel 的 Eloquent ORM 封装了数据库操作，只需要导入表到数据库中即可。当然了，您也可以使用您自己的逻辑

注意

• 请配合开发者工具和js-sdk使用

安装

只需要五步即可完成安装部署。, _(*3)

1. 通过 composer 安装: composer require jmluang/weapp:2.*, _(*4)

2. 添加 Provider 到config/app.php中, _(*5)

 'providers' =>[
     // Laravel Framework Service Providers
     // ...
     jmluang\\weapp\\WeappLoginServiceProvider::class,
 ]

1. 发布配置文件

php artisan vendor:publish --provider="jmluang\weapp\WeappLoginServiceProvider"

参数如下：, _(*6)

配置参数有两种方法，一种是直接写到weapp.php文件中，另一种是写到.env文件中，使用哪种方法都可以。但是有一点需要注意，若你的项目会发布到开源社区，则不推荐使用第一种方法，因为这样做存在泄露信息的风险。, _(*7)

WxLoginExpires 和 NetworkTimeout 都使用了默认的参数，如果你有特殊的需求需要改这两个参数，只要取消备注并填写即可。, _(*8)

1. 添加数据库 Facade 到config/app.php中

'aliases' => [
    // Laravel Framework Facades
    // ...
    'WeappUserRepository' => jmluang\weapp\Facades\WeappUserRepository::class,
    'WeappUser' => jmluang\weapp\Facades\WeappUser::class,
]

若重写了数据库逻辑，则这里应该使用你自己的 Facade 类：, _(*9)

'aliases' => [
    // Laravel Framework Facades
    // ...
    'WeappUserRepository' => your\namespace\FacadeClass::class,
    'WeappUser' => your\namespace\ModelClass::class,

1. 迁移数据库

php artisan migrate

若重写了数据库逻辑，则可以忽略这一步, _(*10)

使用方法

1. Laravel 配置 安装完成后，下面创建一个控制器和路由规则 路由文件：

// filepath routes/web.php
<?php 
Route::get('/weapp/login',"LoginController@login");
Route::get('/weapp/user',"LoginController@user");

控制器：, _(*11)

// filepath app/Http/Controllers/LoginController.php
<?php

namespace App\Http\Controllers;
use jmluang\weapp\Constants;
use jmluang\weapp\WeappLoginInterface as LoginInterface;

class LoginController extends Controller
{
    /**
     * 首次登陆
     * @param LoginInterface $login
     * @return array
     */
    public function login(LoginInterface $login)
    {
        $result = $login::login();

        if ($result['loginState'] === Constants::S_AUTH) {
            return [
                'code' => 0,
                'data' => $result['userinfo']
            ];
        } else {
            return [
                'code' => -1,
                'error' => $result['error']
            ];
        }
    }

    /**
     * 登陆过就使用这个接口
     * @param LoginInterface $login
     * @return array
     */
    public function user(LoginInterface $login)
    {
        $result = $login::check();

        if ($result['loginState'] === Constants::S_AUTH) {
            return [
                'code' => 0,
                'data' => $result['userinfo']
            ];
        } else {
            return [
                'code' => -1,
                'data' => []
            ];
        }
    }
}

1. 微信小程序中 首先在小程序中引入 js-skd，然后就可以写相关的逻辑了

// 目录结构
project
├── app.js
├── app.json
├── app.wxss
├── ...
└── vendor
    └── weapp-login
        ├── lib
        │   ├── constants.js
        │   ├── login.js
        │   ├── request.js
        │   ├── session.js
        │   └── utils.js
        └── weapp.js

// filepath app.js
var login = require('./vendor/weapp-login/weapp')

App({
    onLaunch: function(){
        // 设置登陆url，对应上面Controll的Login方法
        login.setLoginUrl("https://localhost/weapp/login")
        login.login({
            success(result) {
                if (result) {
                  // 首次登陆
                  console.log("登陆成功", result)
                } else {
                  // 二次登陆，请求Controller的User方法
                  login.request({
                    url: "https://localhost/weapp/user",
                    login: true,
                    success(result) {
                      console.log("登陆成功", result.data.data)
                    },
                    fail(error) {
                      console.log("登录失败", error)
                    }
                  })
                }
            },
            fail(error) { console.log("登录失败", error) }
        })
    }
})

使用自己的数据库和逻辑

要使用自己的数据库逻辑，只需要简单的三步操作 1. 继承接口类jmluang\weapp\WeappUserInterface 并实现storeUserInfo 和 findUserBySKey方法 2. 创建Facade类 3. 在 config\app.php的aliases数组中使用您的Facade类覆盖jmluang\weapp\Facades\WeappUser::class, _(*12)

'aliases' => [
    // Laravel Framework Facades
    // ...
    // 'WeappUserRepository' => jmluang\weapp\Facades\WeappUser::class,
    'WeappUserRepository' => path\to\your\FacadeClass::class,
]

Done!, _(*13)

若本仓库对您有所帮助，欢迎Start, _(*14)

若发现问题或需要帮助，欢迎提交Issue, _(*15)

感谢！, _(*16)

LICENSE

MIT, _(*17)

Written with StackEdit., _(*18)