使用 Node.js 和 Express 构建文件上传 REST API🔥
介绍
在当今的 Web 应用中，文件上传已成为一项常见功能，使用户能够轻松共享图片、文档和其他文件。作为开发者，您可以使用 Node.js 和 Express 构建文件上传 REST API 来实现此功能，从而为用户提供流畅的体验。本文将逐步指导您完成创建强大且安全的文件上传 API 的过程。
先决条件
开始之前，请确保您的系统已安装以下必备软件：
- Node.js 和 npm：请确保您的计算机上已安装 Node.js 和 npm（Node 包管理器）。
- Express.js：通过初始化一个新的Node.js应用程序并安装Express包来设置Express.js项目。
- Multer：安装 Multer 软件包，这将简化处理 multipart/form-data 的过程，使我们能够处理文件上传。
第一步：项目设置
让我们通过创建一个新目录并初始化一个Node.js项目来启动这个项目：
mkdir file-upload-api
cd file-upload-api
npm init -y
安装 Express.js 和 Multer 软件包：
npm install express multer
步骤二：创建服务器
创建index.js文件并设置基本的 Express 服务器：
// index.js
const express = require('express');
const multer = require('multer');
const app = express();
const port = 3000; // You can use any available port
app.listen(port, () => {
console.log(`Server is running on http://localhost:${port}`);
});
步骤 3：配置 Multer 以进行文件上传
接下来，我们将配置 Multer 来处理文件上传。创建一个名为 uploads 的新文件夹来存储上传的文件：
mkdir uploads
更新 index.js 文件以配置 Multer：
// index.js
const express = require('express');
const multer = require('multer');
const app = express();
const port = 3000;
// Multer Configuration
const storage = multer.diskStorage({
destination: (req, file, cb) => {
cb(null, 'uploads/');
},
filename: (req, file, cb) => {
cb(null, Date.now() + '-' + file.originalname);
},
});
const upload = multer({ storage });
app.listen(port, () => {
console.log(`Server is running on http://localhost:${port}`);
});
步骤 4：定义文件上传端点
现在，我们来创建一个处理文件上传的端点。我们将使用 Multer 中的 upload.single() 中间件来处理字段名为“file”的单个文件上传：
// index.js
const express = require('express');
const multer = require('multer');
const app = express();
const port = 3000;
// Multer Configuration...
// ...
// File Upload Endpoint
app.post('/upload', upload.single('file'), (req, res) => {
if (!req.file) {
return res.status(400).json({ error: 'No file uploaded' });
}
res.json({ message: 'File uploaded successfully', filename: req.file.filename });
});
app.listen(port, () => {
console.log(`Server is running on http://localhost:${port}`);
});
步骤 5：测试 API
node index.js
使用 Postman 或其他 API 客户端工具向http://localhost:3000/upload发送 POST 请求，并将文件作为表单数据附加到请求中，键为“file”。您应该会收到包含成功消息和已上传文件名的响应。
结论
恭喜！您已成功使用 Node.js 和 Express 构建了一个文件上传 REST API。该 API 可以安全高效地处理单个文件上传。您还可以通过添加验证、支持多文件上传或将其与数据库集成以存储文件元数据来进一步增强此 API。
Github 仓库：https://github.com/MalikBilal111/file-upload-node-rest-api
欢迎在LinkedIn和GitHub上关注我，获取最新动态并参与讨论！
文章来源：https://dev.to/malikbilal111/building-a-file-upload-rest-api-with-nodejs-and-express-56l2