后台管理
- 一、前言
- 二、依赖配置
- 三、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 = 8080
const 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
| 键名 | 字段 | 主键 | 不为空 |
|---|---|---|---|
| id | VARCHAR(10) | 1 | 1 |
| username | VARCHAR(45) | 0 | 1 |
| password | VARCHAR(45) | 0 | 1 |
| level | INT | 0 | 1 |
其中，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 登录界面
<template>
<el-form :model="loginForm" class="login-form" ref="form">
<!-- 账户 -->
<el-form-item label="账号" prop="username" :rules="[{ required: true, message: '账号不能为空', trigger: 'blur' }]">
<el-input v-model=loginForm.username />
</el-form-item>
<!-- 密码 -->
<el-form-item label="密码" prop="password" :rules="[{ required: true, message: '密码不能为空', trigger: 'blur' }]">
<el-input v-model="loginForm.password" type="password" />
</el-form-item>
<el-form-item class="last">
<el-button type="primary" @click="checkInfo">登录</el-button>
<el-button type="success" @click="enterRegister">进入注册</el-button>
</el-form-item>
</el-form>
</template>
<script setup>
import { ref, reactive,getCurrentInstance,onMounted } from 'vue'
import { useRouter ,useRoute} from 'vue-router'
import axios from 'axios'
const {proxy}=getCurrentInstance()
const loginForm = reactive({
id: '', username: '', password: '',level:2
})
const router=useRouter()
const route=useRoute()
const request = axios.create({
baseURL:'http://127.0.0.1:8080'
})
//账号验证
const checkInfo = () => {
//服务端验证账号密码
proxy.$refs.form.validate(async (valid,fields) => {
if (valid) {
let userData={}
let res= await request.post('/user/login', { username: loginForm.username, password: loginForm.password })
if (!res.data.data.length) {
alert('用户名或者密码错误！')
} else {
const username=res.data.data[0].username
const level = res.data.data[0].level
router.push({ name:`home${level}`,query:{username}})
}
}
else {
alert('数据不合法！')
}
})
}
//账号注册
const enterRegister = async () => {
router.push({path:'/register'})
}
</script>
<style lang="less" scoped>
.login-form{
width: 250px;
margin: 200px auto;
:deep(.el-form-item__content) {
justify-content: space-between;
}
}
</style>
本次对利用element-plus快速搭建前端表单样式，对于非空也进行一点小小的判断。这里路由传参是，注意params只能使用name切换路由，而且可能是由于版本问题，params请求参数一直未被收集到。登录成功，根据level进入不同的管理界面。
6.2 注册界面
<template>
<el-form :model="registerForm" class="register-form" ref="form" >
<!-- 账户 -->
<el-form-item label="账号" prop="username" :rules="[{ required: true, message: '账号不能为空', trigger: 'blur' }]">
<el-input v-model=registerForm.username />
</el-form-item>
<!-- 密码 -->
<el-form-item label="密码" prop="password" :rules="[{ required: true, message: '密码不能为空', trigger: 'blur' }]">
<el-input v-model="registerForm.password" type="password" />
</el-form-item>
<el-form-item >
<el-button type="primary" @click="sumbitInfo">注册</el-button>
</el-form-item>
</el-form>
</template>
<script setup>
import { ref, reactive, getCurrentInstance } from 'vue'
import { useRouter } from 'vue-router';
import { customAlphabet } from 'nanoid'
import axios from 'axios'
const {proxy} =getCurrentInstance()
const router=useRouter()
//后端请求
const request = axios.create({
baseURL:'http://127.0.0.1:8080'
})
const registerForm = reactive({
id: '', username: '', password: '',level:2
})
const createId = () => {
const nanoid = customAlphabet('vrteam_123456789', 9)
return nanoid()
}
//注册用户
const sumbitInfo = () => {
proxy.$refs.form.validate(async (valid, fields) => {
if (valid) {
//唯一id
registerForm.id = createId()
registerForm.level = 2
let userData={username:registerForm.username}
let onlyCheck = await request.get('/user/check', { params: userData })
if (onlyCheck.data.data.length) {
alert('用户名已存在，请重新输入！')
} else {
let res = await request.post('/user/register', registerForm)
if (res.data.data.affectedRows) {
alert('注册成功')
router.push({path:'/login'})
} else {
alert('注册失败')
}
}
} else {
alert('数据不合法')
}
})
}
</script>
<style lang="less" scoped>
.register-form{
width: 250px;
margin:200px auto;
:deep( .el-form-item__content){
justify-content: space-around;
}
}
</style>
注册界面对于后端有两次请求，一次是判断用户名是否唯一化的预检查，第二次才是真正的写入数据库。对于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!!!。
