后台管理

• • 一、前言
  • 二、依赖配置
  • 三、koa框架
  • 四、数据库
  • 五、路由
  • 六、前端界面
  • • 6.1 登录界面
    • 6.2 注册界面
    • 6.3 展示界面
  • 七、阿里云部署
  • • 7.1 前端项目
    • 7.2 后端node
    • 7.3 mysql安装
    • 7.4 测试
  • 八、总结

一、前言

本篇文章从头到尾过一遍vue3搭建项目的过程，实现一个用户登录、注册，根据身份等级判断登录界面的应用。前端采用vue3+vite+element-plus，后端使用node.js+koa+mysql。

项目开源地址：https://github.com/bosombaby/user_manage

二、依赖配置

{"name": "user_interface","private": true,"version": "0.0.0","type": "module","scripts": {"dev": "vite","build": "vite build","preview": "vite preview"},"dependencies": {"@element-plus/icons-vue": "^2.0.10","axios": "^1.1.3","element-plus": "^2.2.22","nanoid": "^4.0.0","vue": "^3.2.41","vue-router": "^4.0.12"},"devDependencies": {"@vitejs/plugin-vue": "^3.2.0","less": "^4.1.3","unplugin-auto-import": "^0.11.4","unplugin-vue-components": "^0.22.9","vite": "^3.2.3"}
}

• node_modules 文件夹用来存放所有已安装到项目中的包。require() 导入第三方包时，就是从这个目录中查找并加载包。
• package-lock.json 配置文件用来记录 node_modules 目录下的每一个包的下载信息，例如包的名字、版本号、下载地址等。
• package.json项目的名称、版本号、描述等、用到了哪些包、开发期间使用的包、部署使用的包
  • devDependencies ：开发依赖
  • dependencies ：核心依赖
• 注意：程序员不要手动修改 node_modules 或 package-lock.json 文件中的任何代码，npm 包管理工具会自动维护它们，今后在项目开发中，一定要把 node_modules 文件夹，添加到 .gitignore 忽略文件中

三、koa框架

这次采取KOa框架作为后端，Koa是express同一个团队开发，自由度、灵活度更高，异步请求也更加灵活了。后端主要还是对前端接口返回json数据，前端好进行数据处理。

const Koa = require('koa')
const cors=require('@koa/cors')
const router=require('./router/')
const bodyParser=require('koa-bodyparser')//静态变量
const PORT = 8080const app = new Koa()
// 跨域
app.use(bodyParser())
app.use(cors())
app.use(router.routes())app.listen(PORT, () => {console.log(`http://127.0.0.1:${PORT}`);
})

之前看到几个写得比较好的koa框架教程，只不过有点老了，但思想还是通用的。

koa框架

技术博客

四、数据库

user_info

其中，level三个数值0 1 2分别代表超级管理员、管理员、普通用户

这次，刚开始请求数据库资源的时候，只用了简单的async/await，导致后端发送的一直是前端上一次请求的数据，淦！后来，发现对数据库整体请求要单独封装一个Promise对象，代码如下：

const mysql = require('mysql')const pool = mysql.createPool({host: '127.0.0.1',user: 'root',password: '123456',database:'3d_resources'})let query = (sql, values)=> {return new Promise((resolve, reject) => {pool.getConnection((err, connection) => {if (err) {reject('数据库连接出错',err)} else {connection.query(sql, values, (err, results) => {if (err) {reject('数据库语句出错',err)} else {resolve(results)}connection.release()})}})})
}module.exports=query

五、路由

vue3的路由使用和vue2已经完全不一样了，vue3使用起来更加自由，用到什么功能就导入对应的函数，但有时候写代码也下不去手。下面，主要讲解一下路由的基本使用。首先，创建router文件夹，统一管理路由。

import { createRouter, createWebHashHistory } from 'vue-router'const routes = [{path: '/',redirect:'/login'},{path: '/login',name:'login',component:()=>import('../views/Login.vue')},{path: '/register',component:()=>import('../views/Register.vue')},{path: '/layout',component:()=>import('../views/Layout/Layout.vue'),children:[{path: '/layout/home0',name:'home0',component:()=>import('../views/Layout/Home0.vue'),},{path: '/layout/home1',name:'home1',component:()=>import('../views/Layout/Home1.vue'),},{path: '/layout/home2',name:'home2',component:()=>import('../views/Layout/Home2.vue'),},]}
]const router = createRouter({history:createWebHashHistory(),routes,})
export default router

createWebHashHistory()是路径问题，就是访问的时候带有/#/这个符号。Vue-Router有两种模式：hash模式和history模式。默认的路由模式是hash模式。

对于页面路由跳转，使用，传参啥的，使用 useRouter ,useRoute两个生成参数，不使用this了。

推荐文章：vue3中关于路由hash与History的设置

路由关系：

• 登录
• 注册
• 展示
  • 超级管理员界面
  • 管理员界面
  • 用户界面

其中，登录界面可以跳转到注册界面，注册完成跳转到登录界面。登录并且后端数据库验证通过，根据用户的身份进入不同的展示界面。

六、前端界面

6.1 登录界面

本次对利用element-plus快速搭建前端表单样式，对于非空也进行一点小小的判断。这里路由传参是，注意params只能使用name切换路由，而且可能是由于版本问题，params请求参数一直未被收集到。登录成功，根据level进入不同的管理界面。

6.2 注册界面

注册界面对于后端有两次请求，一次是判断用户名是否唯一化的预检查，第二次才是真正的写入数据库。对于id的生成，采用nanoid。

6.3 展示界面

就是普通的展示，没写太多东西，纯纯练手小项目。

七、阿里云部署

都写到这了，就体验一下项目上线的流程吧，本次采用阿里云服务器加上内置的宝塔面板部署。

7.1 前端项目

vue输入命令 npm run build打包项目，生成dist文件夹，文件夹上传服务器，进入宝塔面板。

填写公网ip或者域名，部署网站，这里默认80端口，切换端口再ip后端直接写就行。这里注意一点，端口一定要再宝塔面板的安全和服务器的防火请开启，不然访问不了。

7.2 后端node

这里采

用pm2配置项目，软件商店下载pm2，这里node版本尽量和本机开发环境一致，模块管理也就是npm包管理，这里的项目端口注意开放。这里我部署的时候还有一个问题，终端输入pm2和node -v无法识别command，这里是没有配置环境变量的问题。我们可以使用软连接配置或者写入环境变量，这里直接网上搜一下就行了。

7.3 mysql安装

这里mysql添加，注意数据库的参数要和后端一致，编码也要一致。数据库创建完成之后，把mysql数据导入本地，然后上传服务器。

7.4 测试

没啥问题

八、总结

本次对于vue3+koa前后端交互的项目有了一个大的了解，对于项目开发、上线流程有了一个大体的了解。但对于用户的持久化(cookie、sessioj)、路由限制这些没有应用到项目里面去，后续有时间慢慢完善技术，go!!!。