九旬的博客

知识讲解

koa2框架是一个基于中间件的框架，也就是说，需要使用到的功能，比如路由（koa-router），日志（koa-logger），都可以找到相应的中间件库，即npm包，然后通过app.use(…)引进来。
本文的主题：实现文件上传就是通过引用相应的中间来实现的。 我查了一下资料，发现可以实现文件上传的中间件有3个，选择其中一个就可以了：

  1. koa-body
  2. busboy
  3. koa-multer

关于以上三种中间件的差异可以自行网上查资料，这里我选择比较顺眼的koa-body，实用简单。

代码实现

步骤一：下载koa-body npm包

npm install koa-body --save
1

步骤二：在koa项目中引用koa-body中间件

const koaBody = require('koa-body');
app.use(koaBody({
    multipart: true,
    formidable: {
        maxFileSize: 20010241024    // 设置上传文件大小最大限制，默认2M
    }
}));
1
2
3
4
5
6
7
8

步骤三：使用koa-body中间件后，即可通过ctx.request.files获取上传的文件
提醒：
新版本的koa-body通过ctx.request.files获取上传的文件
旧版本的koa-body通过ctx.request.body.files获取上传的文件
朋友们千万不要入坑哈，本人就入坑过半天。

步骤四：获取到文件之后，通过fs将文件保存到服务器的指定目录 上传单个文件：

router.post('/uploadfile', async (ctx, next) => {
  // 上传单个文件
  const file = ctx.request.files.file; // 获取上传文件
  // 创建可读流
  const reader = fs.createReadStream(file.path);
  let filePath = path.join(__dirname, 'public/upload/') + /${file.name};
  // 创建可写流
  const upStream = fs.createWriteStream(filePath);
  // 可读流通过管道写入可写流
  reader.pipe(upStream);
  return ctx.body = "上传成功！";
});
1
2
3
4
5
6
7
8
9
10
11
12
13

上传多个文件:

router.post('/uploadfiles', async (ctx, next) => {
  // 上传多个文件
  const files = ctx.request.files.file; // 获取上传文件
  for (let file of files) {
    // 创建可读流
    const reader = fs.createReadStream(file.path);
    // 获取上传文件扩展名
    let filePath = path.join(__dirname, 'public/upload/') + /${file.name};
    // 创建可写流
    const upStream = fs.createWriteStream(filePath);
    // 可读流通过管道写入可写流
    reader.pipe(upStream);
  }
 return ctx.body = "上传成功！";
});
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

前端代码

顺便把前端的代码也附上，前端通过提交表单，把文件发送到你的服务器


 <form action="http://localhost:8080/api/upload" method="post" enctype="multipart/form-data">
    <input type="file" name="file" id="file" value="" multiple="multiple" />
    <input type="submit" value="提交"/>
</form>
1
2
3
4
5
6

最后总结

今天在项目中实现文件上传的时候，也一不小心入了一下坑，为什么呢？（请看以上步骤三）
在网上找的大部分资料都是通过ctx.request.body.files来获取上传的文件，这个是旧版本的koa-body的获取文件方法，为了安全考虑，新版本的koa-body采用ctx.request.files来获取文件。
总结原因，以后要学会找官方文档，以官方文档为主，其他文档为辅，这样才对。