laravel admin 的微信扩展包，支持多公众号、多小程序、多微信支付，包含基础接口与后台

laravel admin 的微信扩展包，支持多公众号、多小程序、多微信支付，包含基础接口与后台

Laravel-admin-wechat

Laravel admin 的微信扩展、支持多公众号、多小程序、多微信支付的后台管理，并提供小程序、微信支付的基础接口，在此基础上通过事件、继承等形式完成自定义。

本扩展使用了 EasyWeChat，微信实例使用可移步到 EasyWeChat 文档

关联项目

让你的 laravel-admin 更好看wepy 小程序开发模板

TO DO LIST

公众号与小程序配置 公众号用户 列表用户 同步用户 备注用户 用户标签 公众号菜单 小程序用户 微信支付配置 公众号卡券 卡券列表 同步卡券 创建卡券 投放卡券 微信支付 微信支付配置 js sdk 生成 微信支付订单 微信支付退款 微信支付红包 公众号授权 公众号登录 自动保存用户 中间件 公众号门店 公众号模板消息 公众号素材 公众号客服 开放平台 小程序其他解密接口

安装

安装依赖

composer require hanson/laravel-admin-wechat -vvv

安装

php artisan wechat:install -m

此命令将：

发布 WeChat 所需资源生成微信相关后台菜单创建各个微信相关数据表创建路由文件 routes/wechat_admin 与 routes/wechat_api创建 database/migrations 的相关微信数据库（可自行根据需求做对应修改，可以加字段，不建议删减字段）执行 migrate 操作（去掉 -m 可不执行）

生成 jwt secret

php artisan jwt:secret

配置

修改 config/auth.php （用于小程序登录等接口，如果不需要可以不加）

[ // ... 'mini' => [ 'driver' => 'jwt', 'provider' => 'wechat_user', ] ], 'providers' => [ // ... 'wechat_user' => [ 'driver' => 'eloquent', 'model' => Hanson\LaravelAdminWechat\Models\WechatUser::class, // 你也可以自己继承此 model 后修改为自己的 model ], ]];

接口

对于本人来说， laravel-admin-wechat 另一个有价值的点在于自带的接口，尽管内容不多，但因为做项目比较多经常要新建用户表，写登录逻辑，但实际上代码基本都一样，这也是为什么会提供基础的接口

post api/wechat/mini/check-token 检查token是否过期 post api/wechat/mini/login 使用 code 登录

post api/wechat/mini/decrypt-mobile 解密手机号码 post api/wechat/mini/decrypt-user-info 解密用户信息

高级

此扩展只提供了最基础的业务，但很多情况下企业需要更多样化的业务需求，laravel-admin-wechat 同样提供了十分灵活的自定义方案。

自定义后台

后台路由在 routes/wechat_admin.php 中，你可以自由修改

当你需要对进行细微调整时，可以通过 php artisan admin:controller 自行创建控制器，并修改其继承的类为原来的类，覆盖方法做调整

通用方法

laravel-admin-wechat 的通用函数均在 Hanson\LaravelAdminWechat\Services 内,并提供 Facade 方式进行调用

事件

为了能够实现基础业务外，也能更好的适应各种自定义需求，本扩展使用了事件去实现自定义

在你的 app/Providers/ServiceProvider.php 中

[ 'App\Listeners\AfterSaveUserInfo', ], \Hanson\LaravelAdminWechat\Events\DecryptMobile::class => [ 'App\Listeners\SaveMobile', ], \Hanson\LaravelAdminWechat\Events\OrderPaid::class => [ 'App\Listeners\ChangeOrderStatus', ]];

wechatUser->user()->update([ 'phone' => $event->decryptedData['purePhoneNumber'], 'country_code' => $event->decryptedData['countryCode'], ]); }}

decryptedData['nickname']; $event->wechatUser; }}

order; $order = $wechatOrder->order()->update(['status' => 'paid']); $openId = $wechatOrder->openid; }}

微信支付

laravel-admin-wechat 提供了微信订单表、创建订单以及生成 js 参数等方法，但并没有相关业务参数 地址、商品 等，建议自身生成 orders 表并关联 wechat_orders

// 支付接口示例 '商品标题', 'total_fee' => 100, 'openid' => auth('mini')->user()->openid, // 'out_trade_no' => 'xxx', 选填，如不填写时会自动创建一个订单号 ]; /** * $result['config'] jssdk 所需参数 * $result['order'] WechatOrder 的 model 对象 * $result['unify'] unify 接口返回的结果 */ $result = \Hanson\LaravelAdminWechat\Facades\OrderService::jsConfig('mch id', 'JSAPI', $data); App\Models\Order::create([ 'wechat_order_id' => $result['order']->id, 'status' => 'not paid', 'goods_id' => '...', 'address_id' => '...', ]); return $result; }}

异常捕捉

不但在此项目，在其他项目也建议你对 app/Exceptions/Handler 进行修改，因为对于接口的请求，laravel 默认在错误的情况会返回页面，这不是任何一个开发者所期望的情况

// app/Exceptions/Handler.phpacceptsJson()) { if ($exception instanceof AuthenticationException) { return Response::json(['err_code' => 401, 'err_msg' => 'Unauthenticated'], 401); } return fail($exception->getMessage()); } return parent::render($request, $exception);}

本扩展封装了函数 fail 和 ok 两个接口返回的基础结构，可以使用这两个函数去定义你所有的接口返回

特别鸣谢

EasyWeChat 微信开发包

yisonli/wxmenu 微信菜单的代码来源

定制

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。