第一个web项目-微信小程序后端开发

第一个web项目-微信小程序后端开发

前言

去年暑假一个偶然的机会我和几位同学加入了学院一位老师主持的教改项目，需求是开发一个基于SPOC与翻转课堂的计算机组成原理课程的学习app（类似慕课、知到），后来经过讨论决定降低难度，先做一个微信小程序，附带一个后台管理系统，于是我的第一个web项目就开始了~

需求分析

这里简单介绍下SPOC和翻转课堂的意思

• 翻转课堂

“翻转课堂”（Flipping Classroom）是一种颠覆传统教学由“课堂授课听讲 + 课后作业练习”转变为“课前自主学习 + 课堂协作探究”的新型教学模式。

• SPOC

SPOC（Small Private Online Course）一般被译为小规模限制性在线课程或者小规模私有型网络课程，音译为“私播课”。
这次项目的需求是开发一个学习类型的小程序，用户分为学生和教师，其中学生可以观看视频、课件、动画，完成作业、考试以及发布评论、点赞、回复，而教师可以上传教学视频、课件、动画和发布作业、考试、通知，以及查看学生的学习情况，也可以查看评论回复，及时解答学生的疑惑。

团队分工

团队一共有四个人，总体工作分为产品设计、前端开发、后端开发三部分，然后每部分由两人负责。其中我是负责后端开发的，同时兼任项目负责人（其实也没有听上去那么高大上，只是需要承担更多决策、协调、沟通的角色）。

总体设计

这里分为小程序和管理系统
首先是小程序，放几张使用墨刀制作的原型图，这里多说两句，市面上的小程序基本都是微信授权直接登录，最多绑定手机号，我们这个由于要统计学生的学习情况才设置了注册和登录功能



至于管理系统，由于是10月份才开始做的，而且是我和另一位做后端的同学负责的，时间比较紧，我们作为前端小白没有十分系统的方法去做开发，只是大概确定了需要做哪些模块，每个模块对哪些表的增删改查，这里原型图就不放了（较简陋）

开发工具及编码实现

小程序前端

据我了解，做前端的同学先去微信公众平台注册账号，然后做一些开发设置，具体步骤自行百度。前端用的是微信开发者工具，有不会的基本上在微信开放文档都可以找到，包括许多实用的API。

后端

这里分为数据库、接口代码两部分

数据库

用的是mysql数据库，之前是跟着学堂在线的一个小程序入门教程做的，它推荐的本地开发环境是phpstudy，里面集成了php、mysql、apache、FTP、Nginx以及数据库管理工具phpMyAdmin，关于phpMyAdmin使用请看https://blog.csdn.net/u012767761/article/details/78238487
原本的数据库设计得不好，存在较多冗余数据，后来学习了数据库系统这门课，我进行了大改，先确定有哪些实体以及实体之间的联系，然后画er图，最后再建模，通过外码约束大量减少了冗余，也减少了表的数量。

接口代码

教程使用的是php语言，框架是thinkphp5，开发手册看https://www.kancloud.cn/manual/thinkphp5/118003，我当时是去b站找视频学了下php基础语法，然后就去学原生php以及框架如何操作数据库。然后根据业务逻辑开始编码，其实每个接口（或者叫类里面的一个函数）结构都差不多，主要是三部分：接收前端传来的数据、增/删/改/查、返回结果给前端。
顺便说下代码编辑用的是sublime text3，教程看https://blog.csdn.net/sam976/article/details/75333079/，这个不是ide，没有那么多的功能比如调试、运行，单纯是只有编辑、加注释、格式化等等，这里吐槽下自带的格式化代码功能（先选择代码，再Edit -> Line -> Reindent），有点辣鸡。而且如果有语法错误不会像eclipse那样自动检测出来，之前被坑了几次，肉眼找不到的话只能用postman去测试了。

管理系统前端1.0

一开始我们是不知道还要做个管理系统的，以为所有功能都放在小程序，后来老师跟我们讨论聊到这个问题，我们才知道原来还有这回事，其实就是管理系统应该具有一切功能，即对数据库所有表的增删改查，而小程序只需要有些轻量的功能即可，至于上传大容量文件、查看学习情况这些不够轻量的功能全部放在管理系统。好吧，凡事总有第一次，我们就开始学习基本的前端三件套html,css,javascript。
开始做的时候我们希望先实现功能，界面难看点没有太多关系，于是学了部分三件套的基础后又学了ajax技术（因为要与后端通信），这里最开始用的是创建XMLHttpRequest 对象，用open()方法设置请求类型和url，用send()方法发送数据到后端，直到遇到了jquery，后面的请求统一都用$.ajax()了。
接下来又遇到了一个难点，因为基本都用表格来展示数据，那获取数据后如何动态地加入表格呢？查找资料后用每一条数据拼接成由tr标签包含的字符串，然后用jquery获取表格标签后调用append()方法加入表格中。
除此之外，我们想在每行末尾设置按钮进行事件处理，于是我们append数据的同时也把button标签放入刚才的字符串中，然后给每个button设置id属性，比如用于修改数据的就叫fixi，最后这个i是代表表格第几行，然后添加事件监听，点击button时获取id，然后查看最后一位是多少从而确定是第几行。
这些做法实现起来是挺繁琐的，而且感觉在重复造轮子，我们也做得有点郁闷，因为每个页面基本都要这样做，但是当时没有那么多的时间精力去学习框架，只是想先实现功能（u1s1，上学期的课多到我快吐了）。
放两张界面图

管理系统前端2.0

之前放假，总算有较多空余时间了，我们决定要改下界面，但毕竟自身水平不高，因此需要用一点第三方的东西了。
在跟小程序前端测试了部分功能后，有一天后端同学找到了一个开源的框架然后我们一起看了下说明文档，最后决定：就用它了。
有请layui登场，经典模块化前端框架、低门槛开箱即用。
真正使用之前可以先看看文档https://www.layui.com/doc/，个人感觉上手还是挺快的。layui提供了许多实用的组件包括弹出层、表格、表单、文件上传、流加载等等。
就拿表格来说，之前我们用append动态添加数据，现在直接table.render()，设置好参数就行了；之前我们给button设置id进行事件处理，现在绑定工具条，直接table.on()就行了；而且之前我们没实现的分页，现在设置分页参数就行了，然后查询数据库时分页读取。
另外，layui提供了一个页面布局的模板，包括logo、用户名、退出按钮、导航栏以及一些css动画。我们要做的就是按照它的模板来，页面元素的样式也参考它提供的。
有了layui的助攻，我们可以将更多注意力放在业务逻辑上，更多关注用户体验。

测试

后端本地测试

工具：postman
使用：打开一个新窗口，选择请求类型，输入url，设置参数，点击send
这种测试我认为是模拟前端发送数据然后运行后端代码，看结果是否正确，属于白盒测试，但是我们不是专业测试人员，目前这样测试不是做得很规范，只能尽可能想到不同的测试用例。

前后端联合测试

由于放假回家了没办法面对面，只能借助腾讯会议线上测了。
在部署工作完成之后，一般是我们写好接口代码，然后把url和需要的参数告诉前端同学（这里注意下，微信小程序的请求api只允许https开头的url，而且前端必须在微信公众平台配置好合法域名，不然会报错），前端把这些东西填入那个wx.request的api然后运行，他们会查看返回的数据是否正确，我们会查看数据库的情况，如果没问题会测试多几个数据，都可以的话就到下一个功能，这种方式应该是属于软工讲到的V模型的单元测试。

部署

用的是新浪云，实名认证、学生认证后会送一些云豆（新浪云的计费单位，1RMB=100云豆）
跟着之前说的教程把整个thinkphp项目部署到新浪云，具体步骤看https://www.kancloud.cn/cnzxo/sae_thinkphp/1423806

• 代码

在代码管理那里可上传压缩包，或者在线编辑（跟记事本差不多），改动大的最好在本地写好再贴上去

• 数据库

开启共享型mysql服务，目前用了phpmyadmin4.9版本，然后建表或导入sql文件

• 缓存

开启memcached服务，设置容量16MB（省点钱），其实这个服务我不是很清楚干什么的，但如果不打开访问接口时会报致命错误？

• 文件存储

我们需要保存许多类型的文件包括视频、课件、动画、作业、考试、头像，因此需要存放在服务端。这里开启storage服务，使用方法看https://www.sinacloud.com/doc/sae/php/storage.html#cyberduck，普通用户配额5个bucket，每个容量10G，然后直接当作本地磁盘那样用就行了，控制台或写代码都可上传文件，上传后获得url，然后就可以通过网络访问，关于新浪云环境下php如何操作看官方文档http://apidoc.sinaapp.com/source-class-sinacloud.sae.Storage.html#。

• 域名

应用信息可查看二级域名，独立域名需要购买且备案

• 日志

日志中心可查看每次请求的接口、时间、请求方设备等信息

• 其它

控制台还可以实时查看流量统计、资源使用情况，以及消费情况

总结

这个项目我也算前后端都做了一遍，感觉前端不太适合自己，可能是对页面元素样式、用户体验不够敏感，不过必须承认前端是挺有意思的。至于后端是更加注重逻辑，目前我对后端的了解只停留在数据库、网络、部署层面，其实如果用户数量非常多还要考虑高并发的问题，也就要使用多线程、负载均衡、消息队列等技术了，所以还有很多技术需要学习。
最后感谢老师的支持和几位队友的帮助。第一次写博客，若有描述不当之处欢迎指出。