connect-busboy 使用教程

项目介绍

connect-busboy 是一个用于 Node.js 的中间件，它将 busboy 库封装成兼容 connect 的中间件。busboy 是一个用于解析 multipart/form-data 格式的库，主要用于处理文件上传。connect-busboy 使得在基于 connect 或 express 的服务器中更容易使用 busboy。

项目快速启动

安装

首先，你需要安装 connect-busboy：

npm install connect-busboy

基本使用

以下是一个简单的示例，展示如何在 express 应用中使用 connect-busboy：

const express = require('express');
const connectBusboy = require('connect-busboy');
const path = require('path');
const fs = require('fs');

const app = express();

app.use(connectBusboy());

app.post('/upload', (req, res) => {
  req.busboy.on('file', (fieldname, file, filename) => {
    const fstream = fs.createWriteStream(path.join(__dirname, 'uploads', filename));
    file.pipe(fstream);
    fstream.on('close', () => {
      res.send('File uploaded successfully');
    });
  });
  req.pipe(req.busboy);
});

app.listen(3000, () => {
  console.log('Server is running on http://localhost:3000');
});

应用案例和最佳实践

文件上传处理

在实际应用中，你可能需要对上传的文件进行更多的处理，例如验证文件类型、限制文件大小等。以下是一个更复杂的示例：

app.post('/upload', (req, res) => {
  req.busboy.on('file', (fieldname, file, filename, encoding, mimetype) => {
    if (mimetype !== 'image/png' && mimetype !== 'image/jpeg') {
      return res.status(400).send('Invalid file type');
    }

    const fstream = fs.createWriteStream(path.join(__dirname, 'uploads', filename));
    file.pipe(fstream);
    fstream.on('close', () => {
      res.send('File uploaded successfully');
    });
  });
  req.pipe(req.busboy);
});

多文件上传

如果你需要处理多文件上传，可以使用 busboy 的 on('field') 事件来处理表单字段：

app.post('/upload', (req, res) => {
  const files = [];

  req.busboy.on('file', (fieldname, file, filename) => {
    const fstream = fs.createWriteStream(path.join(__dirname, 'uploads', filename));
    file.pipe(fstream);
    files.push(filename);
  });

  req.busboy.on('finish', () => {
    res.send(`Files uploaded: ${files.join(', ')}`);
  });

  req.pipe(req.busboy);
});

典型生态项目

express-busboy

express-busboy 是一个基于 connect-busboy 的库，专门为 express 框架设计。它简化了在 express 应用中使用 busboy 的过程。

安装

npm install express-busboy

使用

const express = require('express');
const expressBusboy = require('express-busboy');

const app = express();
expressBusboy.extend(app);

app.post('/upload', (req, res) => {
  console.log(req.files);
  res.send('Files uploaded');
});

app.listen(3000, () => {
  console.log('Server is running on http://localhost:3000');
});

通过使用 express-busboy，你可以更方便地处理文件上传，并且可以直接访问 req.files 对象来获取上传的文件信息。

---

以上是 connect-busboy 的基本使用教程，