Koa搭建简单服务器

1. dependencies

"co-mysql": "^1.0.0",
"koa": "^2.7.0",
"koa-better-body": "^3.0.4",
"koa-ejs": "^4.2.0",
"koa-router": "^7.4.0",
"koa-session": "^5.12.0",
"koa-static": "^5.0.0",
"mysql": "^2.17.1"

2. 主服务

引包

 const fs = require('fs');
 const path = require('path');
 const Koa = require('koa');
 const Router = require('koa-router');
 const session = require('koa-session');
 const ejs = require('koa-ejs');
 const body = require('koa-better-body');

 const _static = require('./routers/static');
 const config = require('./config');

 const app = new Koa();
 const router = new Router();

错误处理

 router.all('*', async (ctx, next) => { // * 表示所有的请求，都会经过这里的处理
     try {
         await next();
     } catch (e) {
         ctx.throw(500, e);
     }
 });

服务端渲染 koa-ejs

 ejs(app, {
     root: path.resolve(__dirname, 'template'), // 模版路劲
     layout: false, // 使用 render 方法渲染模版时有所区别，如果省略，会去找 template/layout.ejs
　　　　　　　　　　　　 // false: ctx.render('admin/index.ejs') 'abc': ctx.render('abc/admin/index.ejs')
     viewExt: 'ejs',// 模版后缀名
     cache: false,  // 缓存
     debug: false   // 如果是 true，会把编译之后的内容全部输出
 });

路由 koa-router

 router.use('/admin', require('./routers/admin')); // localhost:8080/admin/xxx
 router.use('/api', require('./routers/api')); // localhost:8080/api/xxx
 router.use('', require('./routers/www')); // '' 表示根，localhost:8080/xxx

开放静态资源 koa-static

_static(router, {
    imageMaxAge: config.imageMaxAge,
    scriptMaxAge: config.scriptMaxAge,
    styleMaxAge: config.styleMaxAge,
    htmlMaxAge: config.htmlMaxAge,
    otherMaxAge: config.otherMaxAge
});
/*
　　// 上面只是封装了, 比如
　　// ...
　　const static = require('koa-static');
　　// ...
　　router.all(/\.jsx?/i, static(path, options));
*/

session koa-session

1. .keys 文件是通过脚本生成的用来 session 签名的密钥，数组，每个元素都是无规律的不同字符组合

2. 这里可以使用同步读取文件的方式，因为是在启动服务的时候，只读取一次，所以，不会影响服务器性能

 app.keys = fs.readFileSync('.keys').toString().split('\r\n');
 app.use(session({
     maxAge: 20 * 60 * 1000, // 缓存时间 20 分钟
     renew: true // 自动续期
 }, app));

处理 POST 数据 koa-better-body

 app.use(body({
     uploadDir: config.UPLOAD_DIR
 }));

数据库 mysql co-mysql

1 app.context.db = require('./libs/database'); // app.context 相当于 ctx 的原型，所以，可以使用 ctx.db.query(sql语句) 来操作数据库

配置

1. 很多地方都需要 config，直接加到 app.context 上，通过 ctx.config 使用

 app.context.config = config;

 app.listen(config.HTTP_PORT, () => console.log(`Server running on ${config.HTTP_PORT}...`));
 app.use(router.routes());

3. 数据库

 const mysql = require('mysql');
 const co = require('co-mysql');

 const config = require('../config');

 const conn = mysql.createPool({
     host: config.DB_HOST,
     user: config.DB_USER,
     password: config.DB_PASS,
     port: config.DB_PORT,
     database: config.DB_NAME
 });

 module.exports = co(conn);

4. md5

 const crypto = require('crypto');
 const config = require('../config');

 module.exports = {
     // 生成 md5 值
     md5 (buffer) {
         const obj = crypto.createHash('md5');
         obj.update(buffer + config.MD5_KEYS);
         return obj.digest('hex');
     }
 };