1、初始化项目,在项目目录下
npm init -y
2、安装所需库
npm install koa koa-art-template art-template dotenv knex koa-bodyparser koa-multer koa-onerror koa-router koa-static koa-views koa2-cors mysql2
npm install nodemon --save--dev
3、根目录下,配置环境文件.env
PORT=3008
DB_DIALECT=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=koacms
DB_USERNAME=root
DB_PASSWORD=123456
BASE_URL=http://localhost:3000
NODE_ENV=production
4、配置数据库连接文件,新建config文件夹,新建knex.js文件
这个项目我用的是knex.js(JavaScript 版SQL 查询构造器)
5、新建views文件夹,并新建index.html文件
// index.html 用于测试服务是否成功
<!DOCTYPE html>
<html>
<head>
<title>{{title}}</title>
</head>
<body>
<h1>{{message}}</h1>
</body>
</html>
6、在根目录下,新建app.js文件
const Koa = require('koa')
const app = new Koa()
const views = require('koa-art-template');
const path = require('path');
const onerror = require('koa-onerror')
const bodyparser = require('koa-bodyparser')
const Cors = require('koa2-cors')
// error handler
onerror(app)
app.use(Cors({
credentials: true
}))
// middlewares
app.use(bodyparser({
enableTypes:['json', 'form', 'text']
}))
// 配置art-template
views(app, {
root: path.join(__dirname, 'views'), // 视图文件夹路径
extname: '.html', // 模板文件扩展名
debug: process.env.NODE_ENV !== 'production' // 是否开启调试模式
});
// 配置静态文件目录
app.use(require('koa-static')(path.join(__dirname, '/public')));
// 路由
app.use(async (ctx) => {
await ctx.render('index', {
title: 'Hello Koa',
message: 'Hello, koacms!'
});
});
// error-handling
app.on('error', (err, ctx) => {
console.error('server error', err, ctx)
});
module.exports = app
7、新建bin文件夹,新建www文件
#!/usr/bin/env node
/**
* Module dependencies.
*/
var app = require('../app');
var debug = require('debug')('demo:server');
var http = require('http');
require('dotenv').config();
/**
* Get port from environment and store in Express.
*/
var port = normalizePort(process.env.PORT || '3000');
// app.set('port', port);
/**
* Create HTTP server.
*/
var server = http.createServer(app.callback());
/**
* Listen on provided port, on all network interfaces.
*/
server.listen(port);
server.on('error', onError);
server.on('listening', onListening);
/**
* Normalize a port into a number, string, or false.
*/
function normalizePort(val) {
var port = parseInt(val, 10);
if (isNaN(port)) {
// named pipe
return val;
}
if (port >= 0) {
// port number
return port;
}
return false;
}
/**
* Event listener for HTTP server "error" event.
*/
function onError(error) {
if (error.syscall !== 'listen') {
throw error;
}
var bind = typeof port === 'string'
? 'Pipe ' + port
: 'Port ' + port;
// handle specific listen errors with friendly messages
switch (error.code) {
case 'EACCES':
console.error(bind + ' requires elevated privileges');
process.exit(1);
break;
case 'EADDRINUSE':
console.error(bind + ' is already in use');
process.exit(1);
break;
default:
throw error;
}
}
/**
* Event listener for HTTP server "listening" event.
*/
function onListening() {
var addr = server.address();
var bind = typeof addr === 'string'
? 'pipe ' + addr
: 'port ' + addr.port;
debug('Listening on ' + bind);
}
8、配置醒目启动方法,在根目录package.json中,修改原来的scripts配置
"scripts": {
"start": "node bin/www",
"dev": "cross-env NODE_ENV=dev ./node_modules/.bin/nodemon bin/www",
"prd": "cross-env NODE_ENV=production pm2 start pm2.conf.json",
"test": "echo \"Error: no test specified\" && exit 1"
},
9、启动项目,是否正常启动
npm run dev
我这边环境配置的端口是3008,这个可以自行修改,运行成功的结果