当我们需要将客户端上传的文件保存到服务器，我们通常需要使用后端框架处理相关的请求。在 Node.js 中，Express.js 是最流行的 Web 应用程序框架之一。本文将详细介绍如何使用 Express.js 处理 POST 请求的文件上传。
安装和引入 Multer
Multer 是一个 Node.js 的中间件，用于处理上传的文件。我们需要使用 npm 安装 Multer：
npm install --save multer
然后在 Express.js 中引入 Multer 中间件：
const multer = require('multer');
配置上传文件保存路径和命名
我们需要配置上传的文件保存路径和命名方式。Multer 提供了 diskStorage 方法，用于控制文件的存储。下面的代码将上传的文件保存到 uploads 目录下，并为每个文件生成一个唯一的文件名：
const storage = multer.diskStorage({ destination: (req, file, cb) => { cb(null, 'uploads/'); }, filename: (req, file, cb) => { cb(null, Date.now() + '-' + file.originalname); } });
配置 multer 中间件
我们使用 Multer 中间件处理上传的文件。我们需要调用 Multer() 方法并将配置对象传递给它。在这个配置对象中，我们需要指定上传文件的字段名和文件的最大数量和大小。
const upload = multer({ storage: storage, limits: { fileSize: 1000000 }, // 1MB }).single('file');
在示例代码中，我们将上传的文件保存到 storage 变量中指定的目录，文件名称根据当前日期和原始文件名生成。Multer 中间件使用 single() 方法指定上传文件的字段名。我们还可以使用多个 upload() 函数来处理多个上传字段。
处理上传文件的路由
完成了以上配置后，我们需要在 Express.js 中定义一个路由来处理文件上传请求。我们可以在路由中使用 upload() 方法，它将 Multer 插件配置的函数作为参数传递。
-- -------------------- ---- ------- ----------------------- ----- ---- -- - ----------- ---- ----- -- - -- ----- - ------------------- --------------- -------- ----- ------ -- ------ -------- - ---- - ---------------------- -------------- -------- ---------------- - -- ---展开代码
在示例代码中，我们定义了 /uploadfile 路由来处理文件上传请求。在 upload() 方法中传递 req 和 res 对象以及 Multer 插件的函数。如果发生错误，我们将向客户端发送错误消息。否则，我们将打印上传的文件对象，并向客户端发送成功消息。
客户端上传文件的 HTML 表单
在客户端上，我们需要创建一个上传文件的 HTML 表单。我们需要指定表单的 method 和 enctype 属性。
<form action="/uploadfile" method="POST" enctype="multipart/form-data"> <input type="file" name="file" /> <input type="submit" value="Upload" /> </form>
上传的文件必须具有 type="file" 属性，这将启用文件浏览对话框。在 input 标记中，将 name 属性与服务器端路由名称中的文件字段名称匹配。
完整示例
下面是使用 Express.js 和 Multer 处理文件上传请求的完整示例：
-- -------------------- ---- ------- ----- ------- - ------------------- ----- ------ - ------------------ ----- --- - ---------- ----- ------- - -------------------- ------------ ----- ----- --- -- - -------- ------------ -- --------- ----- ----- --- -- - -------- ---------- - --- - ------------------- - --- ----- ------ - -------- -------- -------- ------- - --------- ------- -- -- --- ------------------ ------------ ----- ---- -- - ---------------------- - --------------- --- ----------------------- ----- ---- -- - ----------- ---- ----- -- - -- ----- - ------------------- --------------- -------- ----- ------ -- ------ -------- - ---- - ---------------------- -------------- -------- ---------------- - -- --- ---------------- -- -- - ------------------- ------- -- ------------------------ ---展开代码
这个示例中的服务器会监听 3000 端口，并提供一个表单，用于上传名为 file 的文件。
结论
在本文中，我们详细介绍了如何使用 Express.js 处理 POST 请求的文件上传。我们使用 Multer 中间件控制文件存储方式和处理请求，并创建一个路由处理上传的文件。此外，我们还创建了一个基本的 HTML 表单，使客户端能够上传文件。
Multer 是 Node.js 上传文件时的强大工具，具有丰富的配置选项和灵活的中间件。使用本文提供的示例可以轻松地开始使用 Multer。
许多应用程序需要上传文件，因此掌握这种技术非常重要。希望本文能对你有所帮助，进一步探索 Node.js 文件上传的世界。
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/66fb3bbf447136260159bd51
