三招带你全面实现微信礼物打赏功能并附代码

GS 448 2024-08-12

教程中的内容未实现识别哪个帖子或文章收到的打款，当然我的站点已经实现，你可以试试哈。有段时间没有写实战类的文章了，今天分享一篇，使用yii2+houjs+yii2-wx实现微信送礼物功能。

先来个效果图

图片.png

简单点说就是点击“送礼物”按钮后出现一个弹出框，里面有很多礼物，点击某个礼物后弹出框刷新并出现一个二维码，微信扫码支付。

当然这个钱会进入到会员的个人账号内，然后提现。

为何要做这样一个功能那？ 说心里话我真心没想过通过这个得到多少，更多算一种激励吧，如果你在我们学习社群分享了有价值的文章，你非常有可能受到我的礼物。

好了，还是说功能吧，功能有几个

建立数据表结构（礼物以及送礼物日志）
使用houjs完成前台弹出框
使用yii2-wx实现支付二维码
为用户增加账户功能
使用yii2-wx的企业付款到零钱和yii2的控制台模式现实为用户打款功能（大于等于2元就打款）。

我勒个去，干货满满呀。开始。

数据表结构

既然是送礼品，那自然包含礼品表，还有送礼物的日志表，我规划如下。

礼物表gift

图片.png

礼物日志表gift_log

图片.png

对于 gift_log 表可以不用lang_id，这里为了统计方便添加了这个字段。

整体思路

用户送礼物的整体逻辑如下

点击“送礼物”和后台进行交互获取此社群礼物列表。
获取数据后使用jsmart引擎渲染出具体礼物的html代码。
使用modal将礼物列表放到弹出框弹出。
点击礼物和后台交互，后台生成二维码返回。
用户扫码付款。
付款成功。

获取礼物列表

接下来我们使用houjs来构建前台功能，关于houjs的使用可以去社群查看传送门，我们主要使用其modal弹出框助手和jsmart模板引擎。

首先指定一个按钮

图片.png

data-url代表用于获取礼物列表的路由，为按钮做一个click事件处理

图片.png

发起了一个请求用来获取礼物列表，如果失败则提示错误信息。

接下来我们新建GiftController.php并定义list动作。

图片.png

从这里我们知道现在点击按钮后获得的数据里d.data就是此社群的礼物列表。

当前台得到了礼物列表后，使用jsmart将数据转换成html代码，为此我们需要先做一个jsmart的模板，在送礼物按钮页面增加此模板。

图片.png

这个模板的大体意思就是讲过来的d.data中的数据进行循环，每个礼物放到标签a中，然后我们向后台获取礼物列表的js代码进行补充，如下。

图片.png

进行模板渲染，到了我们看效果的时候了。

图片.png

我很喜欢，使用yii2和houjs的modal&jsmart，完成了礼物列表的功能。接下来我们要做一个重要的事情，和后台交互并且得到支付二维码。

得到支付二维码

在本章我们使用yii2-wx扩展实现微信支付功能，其思路点击礼物后获取支付二维码。

在进行之前我们对上一步的js方法进行优化，将代码放到一个单独的js模块中，在houjs中对于业务上的js代码推荐放到houjs/js/modules中，如下

图片.png

因此获取礼物列表的js代码调用就变的简单了，如下

图片.png

以后关于gift的js代码都可以放到houjs/js/modules/gift.js中。

好，还是说本部分话题。如何获取支付二维码？

我的思路如下：用户点击每个礼品后发起一次get请求到服务器，本次请求包含了礼物的ID，后台收到后生成送礼物日志并和微信服务器通讯得到支付二维码，返回给浏览器，前台渲染此二维码。

说干就干。

首先补充礼物列表，每个礼物的a链接，如下

图片.png

我们为每个礼物的a链接设置了3个属性

class="_get_qrcode" 一个类，这个类并不起到样式作用，主要是为js监听此标签使用。
href="javascript:;" 防止点击跳转
data-url 点击连接后，js函数将根据data-url提供的地址发起请求

接下来我们做一个js方法实现a链接点击的监听，如下

图片.png

有一点要说明，因此礼物列表是在页面dom渲染后加入的html代码，因此如果想让礼物列表的a链接被监听，在获取礼物列表成功后需要调用exports.qrcode()函数进行监听，如下

图片.png

此刻用户点击了礼物的a链接，gift.qrcode()方法开始运作，请求达到了yii2的gift/qrcode动作，我写了如下代码。

图片.png

首先要说明的是上述代码没有问题，但如果上线还是要处理细节的。

在actionQrcode方法中我们做了3件事情

生成送礼物日志
调用yii2-wx生成支付二维码
使用QrCode生成二维码并传给浏览器

这里使用的是yii2-wx提供的生成二维码方法native，剩下的事情就是如何显示这个二维码。

为了让用户可以在支付前重新选择礼物，本次并没有选择弹出二维码，而是使用了礼物页面替换的方法，如下图

图片.png

在礼物的右侧我增加了一个p来存放二维码，没有选择的时候用一些帮助来填充。这个二维码的存放工作由gift.qrcode()方法实现

图片.png

对应的礼物列表模板也增加了支付区域

图片.png

好，看下效果。

图片.png

用户拿手机支付

当用户得到支付二维码后必然是扫码支付，接下来有两个事情要做

yii2要处理微信支付结果通知，将此礼物日志设置为已经支付。
浏览器上次礼物列表二维码消失，提示支付成功。

先来处理结果通知，这个使用yii2-wx非常好实现。在GiftController中增加一个notify动作。

图片.png

对上面的逻辑有几点要注意，这也是我们用yii2-wx的时候要注意的。

关闭csrf验证主要是防止yii2将微信给我们的结果通知请求屏蔽掉。
在设置礼物日志已付款前要判断下，如果已经付款则返回true，这样微信就不会再发请求。

现在我们搞定了回调，看下效果。

图片.png

不错不错

离成功越来越近了！接下来我们要解决一个问题，就是当用户支付后在浏览器上礼物列表的变化，我希望二维码消失同时出现一个支付成功的页面。

我需要一个轮询，那么开始吧，为此我在gift.js中增加一个轮询功能，这个功能在渲染出二维码后被触发。

图片.png

每3秒询问一次服务器上gift/is-pay动作是否此送礼物日志已经付款，当然要告诉是哪个订单，如果已经付款则改变p#payQrcode的内容，否则继续调用exports.askIsPay(id)再一次询问。一点注意的是我们在生成二维码的时候需要服务器将此日志的id返回（这需要服务器的gift/qrcode动作返回此送礼物日志的ID），当exports.askIsPay触发时export.qrcode将其传入。

图片.png