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');
    }
};