这是个什么的项目?
使用 Node.js + Koa2 + MySQL + Vue.js 实战开发一套完整个人博客项目网站。
- 博客线上地址:www.boblog.com
- Github 地址:https://github.com/liangfengbo/nodejs-koa-blog
解决了什么问题?
- 服务端:使用 Node.js 的 Koa2 框架二次开发 Restful API。
- 前端:Vue.js 打造了前端网站和后台管理系统。
项目包含什么功能?
-
Koa2 服务端
- 管理员与权限控制
- 文章
- 文章分类
- 评论文章
- 前端博客网站 Vue.js
- 后台管理系统 Vue.js
项目的特点
- Koa 与 Koa 二次开发 API
- 多 koa-router 拆分路由
- require-directory 自动路由加载
- 异步编程 – async/await
- 异步异常链与全局异常处理
- Sequelize ORM 管理 MySQL
- JWT 权限控制中间件
- 参数验证器 Validator
- nodemon 修改文件自动重启
- 前后端分离
- 使用 Vue.js 搭建前端网站和后台管理系统
如何使用和学习?
数据库
启动项目前一定要在创建好 boblog
数据库。
# 登录数据库
$ mysql -uroot - p 密码
# 创建 wxapp 数据库
$ CREATE DATABASE IF NOT EXISTS boblog DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
克隆项目
首先使克隆项目,然后进入项目根目录使用命令安装包,最后命令启动项目,代码会根据模型自动创建数据库表的。
根目录都是 Node.js + Koa2 API 开发源代码,根目录下的 web 文件夹下都是前端网站项目源代码,根目录下的 admin 文件夹下都是后台管理系统的源代码。
# 克隆项目代码
$ git clone https://github.com/liangfengbo/nodejs-koa-blog.git
# 进入 koa 项目根目录
$ cd nodejs-koa-blog
# 安装包
$ npm install
# 运行服务
$ npm run dev
# 打开浏览器输入回车:http://localhost:3000
// 前端项目使用
1. 在根目录下进入 web 项目:cd web,2. 安装包,执行: npm install 命令,3. 启动服务: npm run dev; 浏览器打开:http://localhost:8080/ 即可以访问。// 后台管理系统使用
1. 在根目录下进入 admin 项目:cd admin,2. 安装包,执行: npm install 命令,3. 启动服务: npm run dev; 浏览器打开:http://localhost:8083/ 即可以访问。
接口说明(重要)
项目的所有接口文档都这里,可以逐个文档看。
- 管理员接口文档说明
- 文章接口文档说明
- 分类接口文档说明
- 评论接口文档说明
License
项目已实现管理员、权限管理、文章、分类、评论等接口,前端模板网站和后台管理系统。自己可以根据项目代码学习,可以到 postman 软件中测试 API 或学习。
喜欢或对你有帮助的话,请你点一个星星 star 鼓励我,或者您有更好的建议和意见,请提出来告知我,可以留言 Issues。希望能够帮助到你学习!Thanks!
MIT, by 梁凤波