https://github.com/buuing/express-blog

使用 Node.js + MySQL 搭建论坛 (自娱项目)
https://github.com/buuing/express-blog

mysql nodejs

Last synced: about 2 months ago
JSON representation

使用 Node.js + MySQL 搭建论坛 (自娱项目)

• Host: GitHub
• URL: https://github.com/buuing/express-blog
• Owner: buuing
• Created: 2018-07-03T13:48:01.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2018-09-21T14:24:15.000Z (almost 8 years ago)
• Last Synced: 2025-03-27T01:15:52.326Z (over 1 year ago)
• Topics: mysql, nodejs
• Language: CSS
• Homepage:
• Size: 121 KB
• Stars: 1
• Watchers: 0
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          

> git clone https://github.com/buuing/express-blog.git

`npm install`

`npm run dev`

`127.0.0.1:8080`

---




## 项目描述

使用node.js搭建一个类似于论坛社区的门户网站，在这里用户可以进行登陆注册等一系列相关操作，登陆成功后可以发帖、评论、删除文章等...




## 项目介绍

使用express框架来构建node项目

> `npm i express`

```

// 加载模块

const express = require('express')

// 创建服务器实例

const app = express()

```

---

使用art-template模板引擎渲染页面和数据

> `npm i art-template express-art-template`

```

// 如果需要渲染ajax请求来的数据, 则需要删除<%= %>语法规则

require('art-template').defaults.rules.shift()

// 配置模板引擎

app.engine('html', require('express-art-template'))

```

然后在前端引入web

---

使用内置中间件开放静态资源目录

```

// 开放静态资源目录

app.use('/node_modules', express.static('./node_modules/'))

app.use('/public', express.static('./public/'))

```

---

使用router进行路由管理

```

// 创建路由实例

const router = express.Router()

// 挂载路由容器到app中,使路由生效

app.use(router)

```

---

使用body-parser处理表单请求

> `npm i body-parser`

```

// 配置 body-parser

app.use(bodyParser.urlencoded({ extended: true }))

// app.use(bodyParser.json())

```

---

使用mysql数据库模块来处理数据交互

> `npm i mysql`

```

// 加载mysql模块

const mysql = require('mysql')

// 创建连接池

const pool = mysql.createPool(dbConfig)

// 封装私有的执行sql方法

exports.query = (...args) => {

  const callback = args.pop()

  // 从连接池中获取连接

  pool.getConnection((err, connection) => {

    if (err) {

      return callback(err, undefined)

    }

    // 执行sql语句

    connection.query(...args, (...results) => {

      // 释放连接

      connection.release()

      // .

      callback(...results)

    })

  })

}

```

---

使用MD5进行数据加密

> `npm i blueimp-md5`

```

// 加载MD5模块

const md5 = require('blueimp-md5')

// 数据加密

data.password = md5(data.password)

```

---

使用session存储用户登录状态,并使用express-mysql-session持久化存储登录状态

> `npm i express-session express-mysql-session`

```

// 加载session模块

const session = require('express-session')

const MySQLStore = require('express-mysql-session')(session)

// 配置信息

const options = {

  host: '127.0.0.1',

  port: 3306,

  user: 'root',

  password: '1234',

  database: 'test'

}

// 配置session开启会话

app.use(session({

  // 自定义加密字符串

  secret: 'buuing.com',

  // 持久化存储

  store: sessionStore,

  // 配置cookie

  cookie: {

    // 过期时间(单位为毫秒)

    maxAge: 1000*60*60*12*1

  },

  resave: false,

  // 使用session才会配发秘钥

  saveUninitialized: false

}))

// 添加用户登录状态

req.session.user = user

```

---

使用app.use中间件处理错误

```

// 配置错误处理中间件

app.use((err, req, res, next) => {

  res.status(500).send({

    error: err.message

  })

})

```

只需要在后面的函数中`return next(err)`即可

---

使用app.locals全局模板对象,来存储session中的用户信息

```

app.use((req, res, next) => {

  app.locals.user = req.session.user

})

```

---

使用jquery-form处理表单数据

> `npm i jquery-form`

```

$('#form').on('submit', function (e) {

  e.preventDefault()

  $(this).ajaxSubmit((res) => {

    console.log(res)

  })

})

```

---

使用moment时间类库处理时间

> `npm i moment`

```

// 加载moment模块

const moment = require('moment')

// 调用

moment().format('YYYY-MM-DD HH:mm:ss')

```

---

使用第三方中间件response-time记录响应时间

> `npm i response-time`

```

// 加载模块

const responseTime = require('response-time')

// 会自动在http响应头中加入响应时间相关信息

app.use(responseTime())

```

---

使用esLint代码风格强校验工具

> `npm i eslint nodemon --save-dev`

> `./node_modules/.bin/eslint --init`

在package.json文件中加入如下代码, 使每次重启服务器都进进行一次代码校验

```

"scripts": {

  "prestart": "eslint ./",

  "start": "node ./app.js",

  "dev": "nodemon --exec npm start"

},

```

---

使用bootstrap和jquery渲染css样式布局和数据交互

> `npm i bootstrap@3.3.7 jquery`




## 目录结构

- controller 控制器

- middlewares 中间件模块

- models 模型

- node_modules 第三方模块

- public 静态资源

- routes 路由模块

- view 视图

- .gitignore 忽略文件

- app.js 入口文件

- config.js 配置文件

- ithub.sql 数据表信息

- package-lock.json

- package.json

- README.MD 说明文件




## 路由设计

| 请求方式 | 请求路径 | 说明

| ------ | --------- | ----

| GET    | /         | 渲染首页

| GET    | /login    | 渲染登录页

| POST   | /login    | 处理登录请求

| GET    | /register | 渲染注册页

| POST   | /register | 处理注册请求

| GET    | /logout   | 处理退出请求

| GET    | /topic/create        | 渲染文章发布页面

| POST   | /topic/create        | 处理文章发布请求

| GET    | /topic/:topicId      | 渲染文章页面

| GET    | /topic/:topicId/edit | 渲染文章修改页面

| POST   | /topic/:topicId/edit | 处理文章修改请求

| POST   | /topic/:topicId/del  | 处理文章删除请求

| GET    | /topic/:topicId/comment                 | 获取所有评论

| POST   | /topic/:topicId/comment                 | 发表评论

| GET    | /topic/:topicId/comment/:commentId/edit | 获取编辑评论内容

| POST   | /topic/:topicId/comment/:commentId/edit | 处理编辑请求

| POST   | /topic/:topicId/comment/:commentId/del  | 处理删除请求




## 数据库设计

```

SET FOREIGN_KEY_CHECKS=0;

```

### 用户表

```

DROP TABLE IF EXISTS `users`;

CREATE TABLE `users` (

  `id` int(11) NOT NULL AUTO_INCREMENT,

  `email` varchar(50) NOT NULL,

  `password` varchar(50) NOT NULL,

  `nickname` varchar(20) NOT NULL,

  `avatar` varchar(100) DEFAULT NULL,

  `bio` varchar(100) DEFAULT '',

  `gender` bit(1) DEFAULT NULL,

  `birthday` date DEFAULT NULL,

  `isDeleted` bit(1) DEFAULT b'0',

  `createdAt` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,

  `updatedAt` timestamp NOT NULL DEFAULT '0000-00-00 00:00:00',

  PRIMARY KEY (`id`)

) ENGINE=InnoDB AUTO_INCREMENT=68 DEFAULT CHARSET=utf8;

```

### 文章表

```

DROP TABLE IF EXISTS `topics`;

CREATE TABLE `topics` (

  `id` int(11) NOT NULL AUTO_INCREMENT,

  `title` varchar(255) NOT NULL,

  `content` longtext NOT NULL,

  `categoryId` int(11) DEFAULT NULL,

  `userId` int(11) NOT NULL,

  `createdAt` timestamp NOT NULL,

  `updatedAt` timestamp NOT NULL,

  PRIMARY KEY (`id`)

) ENGINE=InnoDB AUTO_INCREMENT=172 DEFAULT CHARSET=utf8;

```

### 文章分类表

```

DROP TABLE IF EXISTS `topic_categories`;

CREATE TABLE `topic_categories` (

  `id` int(11) NOT NULL AUTO_INCREMENT,

  `name` varchar(255) NOT NULL,

  `createdAt` timestamp NOT NULL,

  `updatedAt` timestamp NOT NULL,

  PRIMARY KEY (`id`)

) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8;

```

### 评论表

```

DROP TABLE IF EXISTS `topic_comments`;

CREATE TABLE `topic_comments` (

  `id` int(11) NOT NULL AUTO_INCREMENT,

  `content` varchar(255) NOT NULL,

  `userId` int(255) NOT NULL,

  `topicId` int(255) NOT NULL,

  `createdAt` timestamp NOT NULL,

  `updatedAt` timestamp NOT NULL,

  PRIMARY KEY (`id`)

) ENGINE=InnoDB DEFAULT CHARSET=utf8;

```




## Bug汇总

#### Bug NO.1

- 问题描述：

> 控制器中的`req.body`始终获取不到前端ajax发送过来的数据，页面中console.log打印表单数据有值，但客户端post过来之后，服务端却一直显示undefined

- 解决方案：

> 将挂载路由的代码`app.use(router)`放到所有的配置代码后面