博客第一篇,第一版,vue+node+mysql搭建个人博客,后mysql数据库更换为mongodb,页面布局样式重新设计。
快速搭建 node 后端服务 Github-quick-node-server
准备工作
安装node,这是必须的
新版node自带npm,安装Node.js时会一起安装,npm的作用就是对Node.js依赖的包进行管理,也可以理解为用来安装/卸载Node.js需要装的东西。
验证是否安装成功:
推荐windows下终端工具:cmder
npm安装vue-cli
使用npm下载依赖包是可能有些慢,所以这里可以换上淘宝的镜像cnpm。
打开终端(可以在任何位置),输入npm install cnpm -g --registry=https://registry.npm.taobao.org
cnpm跟npm用法完全一致,只是在执行命令时将npm改为cnpm。
现在来安装vue-cli:输入npm install -g vue-cli
或者 cnpm install -g vue-cli
命令中 -g 表示全局安装,会安装到node安装目录下的node_modules文件夹下,看看里面是不是多了vue-cli文件夹,如果没有,看看npm模块的安装路径
npm config ls
可以查看模块的安装路径 prefix,具体设置请自行百度。
vue-cli快速构建项目
- 选定一个你喜欢的文件夹,进入该文件夹下,之后创建的项目目录就在文件夹下
- 打开终端,进入目标文件夹,以 D:\ 为例,使用webpack模板构建项目,输入
vue init webpack my-blog
此时会自动从github下载文件目录到目标文件夹,上不了github的只能想办法了,从别处把构建好的文件全部拷过来也是可以的。
运行项目
1、进入my-blog文件夹,首先可以看到文件夹下有一个package.json文件,这个文件很重要,里面记录的项目的一些信息和运行成功运行项目必须的一些依赖包,之后安装的一些包也要记录到里面,方便别人拷贝过来你的项目时安装依赖,顺利运行。
2、新版本的 vue-cli 在执行
vue init webpack my-blog
第9步时会有一个选择:
如果选择了Yes,则可跳过步骤3,如果选择了No,则按照步骤3进入文件夹安装依赖。3、终端输入(要在此文件夹下)输入:
cnpm install
install可以简写为 i 即cnpm i
,cnpm安装应该挺快的,安装完成后会看到文件夹下多了个node_modules文件夹,里面就是运行项目所需要的一些依赖包,可以看到此文件夹虽然不大,但是里面文件个数有上千个,所以拷贝起来也是挺麻烦的,所以把依赖包记录到package.json里面,别人只要重新下载安装一下就好了,上传到github上也方便。4、启动项目:输入
npm run dev
,等待浏览器自动打开。
npm run dev 执行的命令即是package.json里 scripts下的dev:node build/dev-server.js"scripts": { "dev": "webpack-dev-server --inline --progress --config build/webpack.dev.conf.js", "start": "npm run dev", "build": "node build/build.js" },
默认端口为8080,若此时8080端口被占用则会出错
... > Starting dev server... events.js:160 throw er; // Unhandled 'error' event ^ Error: listen EADDRINUSE :::8080 .....
可以在D:\my-blog\config\index.js里修改端口
dev: { // Paths assetsSubDirectory: 'static', assetsPublicPath: '/', proxyTable: {}, // Various Dev Server settings host: 'localhost', // can be overwritten by process.env.HOST port: 8080, // can be overwritten by process.env.PORT, if port is in use, a free one will be determined autoOpenBrowser: false, errorOverlay: true, notifyOnErrors: true, poll: false, // https://webpack.js.org/configuration/dev-server/#devserver-watchoptions- // https://webpack.js.org/configuration/devtool/#development devtool: 'cheap-module-eval-source-map', // If you have problems debugging vue-files in devtools, // set this to false - it *may* help // https://vue-loader.vuejs.org/en/options.html#cachebusting cacheBusting: true, cssSourceMap: true },
启动成功后:
... DONE Compiled successfully in 2597ms I Your application is running here: http://localhost:8080
安装需要用到的包
首先安装项目要用到的一些组件,也可以之后遇到什么需要的再安装
- element-ui:饿了么前段组件库,可以帮助快速建立起前段页面,少些很多样式
- vuex:vue状态管理
- axios:基于Promise 用于浏览器和 nodejs 的 HTTP 客户端
- mysql:连接mysql数据库
- express:
- body-parser:
- node-sass:sass-loader依赖
- sass-loader:解析sass/scss文件
可以依次安装( npm 安装很慢的可以使用 cnpm ):
npm install element-ui --save (回车)
npm install vuex --save (回车)
npm install axios --save (回车)
npm install mysql --save (回车)
npm install express --save (回车)
npm install body-parser --save (回车)
npm install node-sass --save-dev (回车)
npm install sass-loader --save-dev (回车)
也可以一起安装:
npm install element-ui vuex axios mysql express body-parser --save (回车)
npm install node-sass sass-loader --save-dev (回车)
--save 意思就是将依赖记录在 package.json 里的 dependencies 下,之后生产环境也是需要这些包的,--sava-dev 是将依赖记录在 package.json 里的 devDependencies 下,只是开发环境需要这些包,方便开发调试,而生产环境不需要。(-S 是 --save 的缩写,-D 是 --save-dev 的缩写)
"dependencies": {
"axios": "^0.18.0",
"body-parser": "^1.18.3",
"element-ui": "^2.3.9",
"express": "^4.16.3",
"mysql": "^2.15.0",
"vue": "^2.5.2", // 项目构建完就有了
"vue-router": "^3.0.1", // 项目构建完就有了 当时"Install vue-router"选了Yes
"vuex": "^3.0.1"
},
"devDependencies": {
...
"node-sass": "^4.9.0",
"sass-loader": "^7.0.1",
...
},
使用scss/sass前必须先安装node-sass、sass-loader,否则运行npm run dev时会报错
<style lang="scss" scoped>
$bgColor: #F90;
.blog-home {
background: $bgColor
}
</style>
调用后台接口 ajax 请求数据
1、打开入口js文件main.js,引入element-ui组件来搭建页面 element-ui 查看官网文档。
// The Vue build version to load with the `import` command
// (runtime-only or standalone) has been set in webpack.base.conf with an alias.
import Vue from 'vue'
import App from './App'
import router from './router'
import axios from 'axios'
import ElementUI from 'element-ui'
import 'element-ui/lib/theme-chalk/index.css'
Vue.config.productionTip = false
Vue.use(ElementUI);
Vue.prototype.$http = axios;
/* eslint-disable no-new */
new Vue({
el: '#app',
router,
components: { App },
template: '<App/>'
})
其中 axios 用来完成 ajax 请求,
import axios from 'axios'
axios.get('/', function() {});
axios.post('/', function() {});
// 将 axios 添加的 Vue 原型上后就不需要再在每个需要使用它的页面引入了
Vue.prototype.$http = axios;
$http.get('/', function() {});
$http.post('/', function() {});
2、每个页面都相当于一个组件,文件以.vue结尾,第一次启动成功时看到的页面就是组件Hello.vue,路径src/components/Hello.vue。路由地址在 src/router/index.js 中配置,打开修改我们待会自己要用的:
import Vue from 'vue'
import Router from 'vue-router'
import HelloWorld from '@/components/HelloWorld'
import Home from '@/components/pages/Home'
import Blog from '@/components/pages/Blog'
Vue.use(Router)
export default new Router({
routes: [
// {
// path: '/',
// name: 'HelloWorld',
// component: HelloWorld
// },
{
path: '/', // http://localhost:8080/#/
name: 'Home',
component: Home
},
{
path: '/blog', // http://localhost:8080/#/blog
name: 'Blog',
component: Blog
}
]
})
上面引入了三个组件HelloWorld.vue(默认),Home.vue,Blog.vue。 path是页面地址,name可以随便写,component 是 import 的组件名。
3、在 scr/components 下新建文件夹 pages,在 pages 下新建文件 Home.vue,Blog.vue,里面按规则要求写好内容,运行工程打开页面 http://localhost:8080/#/、http://localhost:8080/#/blog 即可看到相应的内容。 在 Blog.vue 中输入下面内容用来后面测试调用接口
<template>
<div class="">
<el-button type="primary" @click="getArticle">调用后台接口</el-button>
<el-input v-model="inpContent"></el-input>
</div>
</template>
<script>
export default {
name: 'blog',
data() {
return {
inpContent: 'Blog'
}
},
methods: {
getArticle() {
this.$http.get('/api/getArticle')
.then( (res) => {
console.log('res', res);
this.inpContent = res.data.data;
})
}
}
}
</script>
4、后端使用Express做服务端提供数据接口,不了解的可以先去官网文档大致了解一下 Express官网,在根目录my-blog下创建文件夹server用来存放后端数据库配置数据和相关方法api。
server文件夹下创建文件:index.js
const path = require('path');
const express = require('express');
const app = express();
app.get('/api/getArticle', (req, res, next) => {
res.json({
data: '后台返回结果 getArticle'
})
})
// 监听端口
app.listen(3000);
console.log('success listen at port:3000......');
另开一个 CMD 窗口,进入目录 D:\my-blog\server
D:\my-blog\server
$ node index.js
success listen at port:3000......
5、打开 http://localhost:8080/#/blog 点击按钮"调用后台接口",会发现控制台报错
这是因为我们工程运行的端口是8080,而后端程序运行的端口是3000,所以是跨域请求,要想请求成功,就要先在配置里设置一下代理
6、打开文件 /config/index.js,将 proxyTable 项设置如下
proxyTable: {
'/api': {
target: 'http://localhost:3000/api',
changeOrigin: true,
pathRewrite: {
'^/api': ''
}
}
}
'/api': 表示所有以 /api 为开头的请求,如我们的请求 this.$http.get('/api/getArticle')
target: 将所有以 /api 为开头请求转发到 http://localhost:3000/api
changeOrigin: true/false, Default: false,本地会虚拟一个服务端接收你的请求并代你发送该请求(不太明白,false 试了也可以)
pathRewrite: 重写地址。 '^/api': '' 表示将以 /api 开头的请求的地址中的 '/api' 替换为 '',
即 path = path.replace(/^/api/, '')
eg: this.$http.get('/api/getArticle')
path = '/api/getArticle'
path = path.replace(/^/api/, '') = '/getArticle'
这样目标请求就变成了 http://localhost:3000/api/getArticle , 如果不写 pathRewrite, 请求则为 http://localhost:3000/api/api/getArticle 所以也可以这样proxyTable: { '/api': { target: 'http://localhost:3000', changeOrigin: true, } }
最后请求同样转发为 http://localhost:3000/api/getArticle , 总之要和后台的接口路径对应上,不过还是建议加上 pathRewrite,方便同类方法调用
// server/index.js const path = require('path'); const express = require('express'); const router = express.Router(); const app = express(); app.use('/add', router); app.use('/del', router); router.get('/getArticle1', (req, res, next) => { api.getArticle(req, res, next); }) router.get('/getArticle2', (req, res, next) => { api.getArticle(req, res, next); }) router.get('/delArticle1', (req, res, next) => { api.getArticle(req, res, next); }) router.get('/delArticle2', (req, res, next) => { api.getArticle(req, res, next); }) // 监听端口 app.listen(3000); console.log('success listen at port:3000......'); > connetion.query(sql, [1, "blog"], () => ) var getValue = function() { pool.getConnection((err, connection) => { var sql = 'SELECT * FROM test WHERE id = ?' connection.query(sql, [1], (err, result) => { console.log(result); connection.release(); }) }) } getValue();
/* $ node db.js [ RowDataPacket { id: '1', name: 'blog' } ] */
// 更新数据 var updValue = function() { pool.getConnection((err, connection) => { var sql = 'UPDATE test SET name = ? WHERE id = ?' connection.query(sql, [22, 1], (err, result) => { console.log(result); connection.release(); }) }) } updValue();
// 删除数据 var delValue = function() { pool.getConnection((err, connection) => { var sql = 'DELETE FROM test WHERE id = ?' connection.query(sql, [1], (err, result) => { console.log(result); connection.release(); }) }) } delValue();
结合前面的 ajax 请求数据,我们便可以轻松的对数据库中的数据进行操作了,下面来模块化这些操作。
### 模块化后端代码
在 /server 下创建文件
- db.js 数据库连接配置
- api.js 连接数据库,各种方法实现
- sqlMap.js sql语句
- router.js 后端 express 路由配置
- index.js 后端入口文件,启动后端服务
1、db.js
```js
// 数据库连接配置
module.exports = {
mysql: {
host: 'localhost', // 新建数据库连接时的 主机名或ID地址 内容
user: 'root',
password: '8023', // root 密码
database: 'myBlog', // 数据库名
port: '3306'
}
}
2、api.js
const mysql = require('mysql');
const dbConfig = require('./db');
const sqlMap = require('./sqlMap');
const pool = mysql.createPool({
host: dbConfig.mysql.host,
user: dbConfig.mysql.user,
password: dbConfig.mysql.password,
database: dbConfig.mysql.database,
port: dbConfig.mysql.port,
multipleStatements: true // 多语句查询
});
module.exports = {
getValue(req, res, next) {
var id = req.query.id;
pool.getConnection((err, connection) => {
var sql = sqlMap.getValue;
connection.query(sql, [id], (err, result) => {
res.json(result);
connection.release();
})
})
},
setValue(req, res, next) {
console.log(req.body);
var id = req.body.id, name = req.body.name;
pool.getConnection((err, connection) => {
var sql = sqlMap.setValue;
connection.query(sql, [name, id], (err, result) => {
res.json(result);
connection.release();
})
})
}
}
3、sqlMap.js
var sqlMap = {
getValue: 'SELECT * FROM test WHERE id = ?',
setValue: 'UPDATE test SET name = ? WHERE id = ?'
}
module.exports = sqlMap;
4、router.js
const express = require('express');
const router = express.Router();
const api = require('./api');
router.get('/getValue', (req, res, next) => {
api.getValue(req, res, next);
});
router.post('/setValue', (req, res, next) => {
api.setValue(req, res, next);
});
module.exports = router;
5、index.js
const routerApi = require('./router');
const bodyParser = require('body-parser'); // post 数据是需要
const express = require('express');
const app = express();
app.use(bodyParser.json());
// 后端api路由
app.use('/api', routerApi);
// 监听端口
app.listen(3000);
console.log('success listen at port:3000......');
在 /scr/components/pages/Blog.vue 文件中写入下面代码测试
<template>
<div class="">
<el-input v-model="inpContent"></el-input>
<el-button type="primary" @click="getValue">获取数据</el-button>
<el-button type="primary" @click="setValue">添加数据</el-button>
</div>
</template>
<script>
export default {
name: 'blog',
data() {
return {
inpContent: ''
}
},
methods: {
getValue() {
// axios.get('/', {params: ''})
this.$http.get('/api/getValue', {
params: {id: 1}
}).then( (res) => {
console.log('res', res);
this.inpContent = res.data[0].name;
})
},
setValue() {
// axios.post('/', {})
this.$http.post('/api/setValue', {
id: 1, name: this.inpContent
}).then( (res) => {
console.log('res', res);
})
}
}
}
</script>
- get:第二个参数(可选)是一个对象,以 params 为属性,将条件数据传到后台,后台通过 req.query 可以获得 params 对应的值
- post:第二个参数(可选)也是一个对象,属性任意,将提交数据传到后台,后台通过 req.body 可以获得这个对象,req.body 数据的解析需要用到包 body-parser,在 index.js 中引入 use 即可。
打开两个命令窗口分别运行工程,运行后端服务,即可进行测试:
D:\my-blog
$ npm run dev
D:\my-blog\server
$ node index.js