本周撸了两款小程序,在这里总结下开发过程中的小经验,希望对大家有用。
小程序端
我们先说小程序要注意的地方。
##默认入口转发问题
当一个小程序Page的js文件中存在 onShareAppMessage 方法时,可以触发转发功能,但是通过小程序开发者工具生成的模板中,入口文件的js中并没有此方法,为了发布后方便对小程序进行分享,建议在pages/index/index.js中添加。
当然默认情况下,我们需要点击小程序右上角的…才能看到转发,这样并不能对用户起到引导作用,通常的做法是使用一个button,并且设置open-type为share,这样就可以通过按钮启动分享。
但是原生按钮很难看,我们可以设置一个图片,在wxml内的代码一般如下
<button open-type="share"><image src="/images/icon-share.png"></image></button>
当然需要通过wxss将button的样式去掉,背景、边框等等,代码如下
button {
padding:0;
margin:0 auto;
width:70rpx;
height:70rpx;
display:block;
border:0;
background: transparent;
}
button::after {
border:0;
}
尤其是对 button::after 要进行设置,否则按钮的边框是无法去掉的。
关于登录
关于小程序登录逻辑都差不多,从小程序发一个请求(含code)给服务器代码,服务器通过code换取open_id和session_key,其中open_id我们需要存储,用来表示用户身份,session_key用来获取用户基本信息时解密使用。
当服务器端进行了存储后要生成一个key,将其返给小程序,以后小程序凡是发起需要用户认证的请求,都带这个key用来判断用户身份,在yii2中,这个key就是我们restful中的access_token。
以上是关于小程序登录的前后台逻辑,如果你使用yii2类框架,很多都内置了,并不复杂。
但是这里还有几个问题
-
小程序端何时进行登录逻辑?
-
发起请求时access_token过期了如何处理?
小程序端何时进行登录逻辑?
在登录判断上,我们先进行小程序是否含有access_token来判断,当然即便存在,还需要对checkSession进行一次判断。
var session = Session.get();// 获取access_token
if (session) {
wx.checkSession({
success: function () {
},
fail: function () {
doLogin();
},
});
} else {
doLogin();
}
这里Session是对access_token的一次封装。
发起请求时access_token过期了如何处理?
这个问题最常发生的场景就是我们发送了一次需要用户认证的请求,此刻如果服务器端发现收到的access_token已经失效,会返回异常,此刻小程序一般要如何处理那?
我的推荐方式是静默状态的自动登录一次再,先看代码。
if (response.statusCode === 401) {
Session.clear();
if (!hasRetried) {
hasRetried = true;
doRequestWithLogin();//
return;
}
}
我来解释一下这段代码,当小程序发起一次需要用户认证的请求但是被服务器驳回为401错误(一般为用户认证失败),此刻我先清理掉小程序端自身对access_token(Session.clear()方法实现),然后在进行登录后再发起请求(doRequestWithLogin())。
但是我们不能一直在执行请求失败就登录操作,因此可以设置一个开关hasRetried,只进行一次尝试。
客服消息
在小程序开发中,客服消息的重要性不言而喻,它除了作为客服服务外,还作为小程序到微信浏览器的一个渠道,比如本次在「宝宝爱识图」的开发中,我用它来实现将收款微信号到用户的推送工作,这主要是解决在ios端虚拟产品不能进行微信支付事情。
一般的策略是让客户点击客服按钮然后输入一个关键词,服务器端通过客服消息接口识别用户身份,结合关键词给予响应的消息推送。
模板消息
很多人认为很鸡肋的方法,毕竟需要获取form_id和prepay_id后才能下发模板消息,似乎很受限制,但是我们可以建立一个formId的种子表,将尽可能多的用户和后台的行为都采用form表单提交的形式,并且获取formID,对,要变态的多,这样你的formId表数据起来了,以后想发消息的时候用就好了。
关于如何设置能获取formId的小程序表单也很简单,设置report-submit为真即可,如下代码
<form bindsubmit="abc" report-submit="{{true}}">
</form>
然后在js端通过如下代码获取
abc(event) {
var formId = event.detail.formId;
xxx
},
尽可能多的。
服务器端
接下来总结下服务器端,我使用yii2的restful组件作为接口支持,关于restful的基本功能请参考yii2官方文档或我之前录制的课程《Yii2的RESTful讲解》,在这里分享我认为关键的点。
让yii2能解析json的请求内容
默认情况下yii2并不能识别请求中的json格式,而我们小程序在发起请求时喜欢用它,因此我们要对yii2进行一下配置。
config/web.php
'request' => [
'cookieValidationKey' => 'xxx',
'parsers' => [
'application/json' => 'yii\web\JsonParser',
],
],
对,在web.php中对组件request增加内容解析yii\web\JsonParser。
用户认证
小程序的登录需要服务端的用户认证配合,当然我使用yii2框架,内置的restful已经支持了,如果你的系统不支持用户认证,可以自行建立access_token的生成机制,具体可以参考腾讯开放的小程序服务端框架wafer。
在yii2的restful中的用户认证使用了行为机制,我们来看下流程代码
// 在需要授权的控制器内
class CardController extends ActiveController {
public $modelClass = 'app\modules\say\models\Card';
public function behaviors() {
$behaviors = parent::behaviors();
$behaviors['authenticator'] = [
'class'=>HttpBearerAuth::className(),
'only'=>[
'index'
],
];
return $behaviors;
}
...
}
就如上面的代码,我们生命index动作是需要用户认证的,并且认证机制为HttpBearerAuth类型,在小程序端需要在header内包含如下代码
header: {
'Authorization': 'Bearer ' + access_token
},
当服务器验证通过后,在action的代码内直接使用 Yii::$app->user->id 就可以获得用户ID。
ok~
这就是前几天小程序开发过程中给大家分析的点,后续升级过程中会继续分享给大家。