NanBox

腾讯云 wafer2 上手，轻松部署小程序后端！

发表于  |    |     |   阅读次数

前端程序员开发一个自己的小程序，比起学习小程序开发，更大的难点在于搭建小程序的后台。

本文从一个初学者的角度，简单介绍一下腾讯云推出的小程序解决方案 wafer2，让没有后台开发经验的程序员，也能搭建起自己的小程序后台。

简介

wafer

后台的搭建涉及到购买服务器、购买数据库，然后要在服务器上安装运行环境等。说实话，我连要在服务器上装什么都不知道。所以希望能有一个东西，帮我把这些都做好，要是再提供一些登录之类的常用接口就更好了。这就是 wafer 所做的。

其实在小程序后台配置域名的地方，就有跳转到腾讯云的链接:

进入后按照指引购买，就可以拥有一个配置好的后台。

wafer2

wafer 相对于自己搭建后台已经方便很多了，但我用起来还是感觉有难度。我不熟悉 Linux，也搞不懂如何测试代码。直到发现腾讯云又推出了 wafer2。

如果你用上了新版小程序开发工具，会在工具的右上角发现一个「腾讯云」的按钮：

这个按钮就是用来连接 wafer2 的。

我们可以直接在小程序开发工具里编写后台代码，并上传代码，后台是区分开发环境和生产环境的。

下面我们看看怎么使用 wafer2。

搭建

开发环境

搭建 wafer2 很简单，大家按照官方文档来，应该没什么问题的，这里就不赘述了。

生产环境

官方文档说的都是开发环境，要是你想部署到生产环境，有些配置需要改一下。

域名

开发环境的域名是腾讯云分配的 xxx.qcloud.la，而生产环境需要使用自己在腾讯云里的域名。

通过腾讯云管理中心注册的域名，会自动部署 HTTPS 证书。但是要备案的话，需要登记服务器 ip，而 wafer2 的服务器 ip 是没有提供给我们的。目前备案只能再买一个服务器……

绑定域名后，可以在开发工具「详情」-「腾讯云状态」确认生产环境域名：

切换到生产环境后，别忘了把客户端的接口域名也改一下。

数据库

在腾讯云管理中心里，修改生产环境 MySql 的登录密码。然后登录 phpMyAdmin，在首页可以看到 MySql 的服务器 ip 地址，记下来。

回到开发工具，找到 server/config.js，修改里面 MySql 配置的 ip 地址及登录密码：

1
2
3
4
5
6
7
8
mysql: {
  host: '修改为生产环境 ip',
  port: 3306,
  user: 'root',
  db: 'cAuth',
  pass: '修改为生产环境密码',
  char: 'utf8mb4'
},

在开发工具上传正式代码，再到管理中心的生产环境，点击「代码部署」。这样就完成生产环境的配置及部署了。

比外需要注意，开发环境的 MySql 是 5.7 的，而生产环境是 5.6 的。注意不要在开发的时候使用 JSON 等 MySql 5.7 才有的功能。

登录

先说一下小程序基本都会用到的登录。

使用

wafer2 的客户端及服务端 sdk，已经集成了登录逻辑，在客户端引用 sdk 后，只要调用它的 login 方法就可以实现登录了：

1
2
3
4
5
6
7
8
qcloud.login({
  success: res => {
    console.log('登录成功', res)
  },
  fail: err => {
    console.log('登录失败', err)
  }
})

登录成功会将用户数据保存在数据库 cAuth 的 cSessionInfo 表里，并将用户数据返回。

看起来很美好，但是这里面是存在一些问题的。

问题

用户登录过之后会将用户信息缓存在本地，当有缓存的时候会将用户信息直接返回。但是 sdk 中，缓存的存取都是有问题的，有缓存的情况下，会返回 undifined。

这是个很低级的错误，问题已经给官方反馈了。截止到写这篇文章，取数据的地方改了，但存的地方还没改……

所以现在要正常使用，需要到 wafer2-client-sdk/lib/login.js，找到保存用户数据的地方：

1
Session.set(res.skey);

修改为：

1
Session.set(res);

另外，还想吐槽一下，sdk 里 wx.login 和 wx.getUserInfo 是搭配使用的。

也就是说，必须要获取到用户信息，才能实现登录。而我们知道，小程序在获取用户信息时会弹窗，并且用户是可以拒绝的。拒绝后一段时间内，调用 wx.getUserInfo 都不会再弹窗。可以说 wafer2 没有考虑用户拒绝授权的情况。而这恰好是微信不提倡的做法，甚至可能导致无法通过审核。

这个问题我也向官方反馈了。

第一个接口

学习要有目的性才能保持兴趣，配置完了我们来写一个自己的接口。

wafer2 基于 Node.js 平台，使用了 Koa2 框架。

在 server/controllers 下新建文件 hello.js，输入如下代码：

1
2
3
module.exports = async ctx => {
  ctx.state.data = "Hello World !"
}

代码很简单，就是暴露一个返回结果是「Hello World !」的方法，「Hello World !」会被放在请求结果的 data 里。

然后我们打开 server/routes/index.js

添加一句代码：

1
2
// 测试接口
router.get('/hello', controllers.hello)

代码就只有这么多。保存之后点击「腾讯云」-「上传测试代码」，如果是第一次上传要勾上「部署后自动安装依赖」。等待上传成功，就可以测试我们的接口了。

调用 xxx.qcloud.la/weapp/hello，看是否返回以下结果：

1
2
3
4
{
  code: 0,
  data: "Hello World !"
}

恭喜！你自己开发的第一个接口已经调通了！

数据库操作

wafer2 使用了 knex 作为数据库的查询构造器，并且已经配置好了。对于有 sql 经验的程序员，可以很快的上手。

我们可以在 phpMyAdmin 里，在 cAppinfo 这个数据库里创建需要的表。

假如已经有一个「Book」的表，下面代码，简单展示了在 wafer2 里，如何对数据库进行增查改删：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
const { mysql } = require('../qcloud')
const uuid = require('node-uuid')
module.exports = async ctx => {
  var id = uuid.v1()
  // 增
  var book = {
    id: id,
    name: "冰与火之歌",
    price: 88
  }
  await mysql("Book").insert(book)
  // 查
  var res = await mysql("Book").where({ id }).first()
  // 改
  await mysql("Book").update({ price: 66 }).where({ id })
  // 删
  await mysql("Book").del().where({ id })
  ctx.state.data = "OK"
}

数据库操作默认都是异步执行的，如果要等待操作完成，需要在操作语句前加上 await。

更高级的 sql 用法，可以查看 knex.js 官网。

总结

我已经将自己的小程序「碰词er」后台迁移到 wafer2 了。开发的时候各种坑，给腾讯云提了一些很明显的 bug。说不定「碰词er」是第一个使用 wafer2 的小程序。

wafer2 用起来方便。我们不用懂太多后台配置的东西，前后端代码都在小程序开发工具编写，直接在开发工具上传后端代码，区分了开发、生产环境，而且目前还是免费的，虽说不知道会不会一直有免费版。

但目前缺点同样明显，比如备案不方便，登录接口不合理，sdk 有 bug 等。我还碰到服务器宕机，需要重启的情况。希望腾讯云接下来能解决这些问题。

总的来说，wafer2 使用门槛低，但现在还不够稳定。个人项目玩玩还是可以的，商业项目要用的话，建议再观察一段时间吧。

刚开始，在没有推广的情况下，在我身边的人都不愿意玩的情况下，每天会有一两百个新用户。在上次知晓程序推荐过后，现在居然每天有一两千个新用户！流量费都快给不起了，非常感谢大家的捧场。

最后，感谢我家宝宝做了这么好看的设计图。