웹 개발 세계에서는 파일 업로드 처리가 일반적인 요구 사항입니다. 프로필 사진, 문서, 이미지 등 많은 애플리케이션에서는 파일을 안전하고 효율적으로 업로드하고 저장해야 합니다. Express와 함께 Node.js를 사용할 때 Multer는 이 작업을 원활하게 처리하는 데 사용할 수 있는 최고의 라이브러리 중 하나입니다.
이 블로그에서는 설치, 구성, 저장 옵션, 파일 필터링, 일반적인 사용 사례 등 Node.js에서 Multer를 사용하는 데 필요한 모든 내용을 코드 예제와 함께 다룹니다.
Multer는 웹 애플리케이션에서 파일을 업로드하는 데 일반적으로 사용되는 형식인 multipart/form-data를 처리하기 위한 미들웨어입니다. Express와 함께 작동하도록 특별히 설계되었으며 다음을 제공하여 파일 업로드를 관리하는 데 도움이 됩니다.
Multer를 시작하려면 npm을 통해 설치하세요.
npm install multer
Express 애플리케이션에서 Multer를 사용하여 기본 파일 업로드 핸들러를 설정하는 것부터 시작해 보겠습니다. 시작하는 방법은 다음과 같습니다.
const express = require('express');
const multer = require('multer');
const app = express();
// Configure Multer for basic usage
const upload = multer({ dest: 'uploads/' }); // Destination folder for uploaded files
// Single File Upload Route
app.post('/upload', upload.single('file'), (req, res) => {
res.send('File uploaded successfully!');
});
app.listen(3000, () => console.log('Server running on port 3000'));
이 예에서는:
Multer는 두 가지 기본 저장 옵션을 제공합니다.
디스크 저장소를 사용하면 파일 이름 지정 및 대상 경로를 더 효과적으로 제어할 수 있습니다.
npm install multer
메모리 저장소에는 파일이 버퍼로 저장되는데, 이는 수명이 짧은 파일이나 디스크에 파일을 저장하지 않고 업로드를 처리하는 데 유용합니다.
const express = require('express');
const multer = require('multer');
const app = express();
// Configure Multer for basic usage
const upload = multer({ dest: 'uploads/' }); // Destination folder for uploaded files
// Single File Upload Route
app.post('/upload', upload.single('file'), (req, res) => {
res.send('File uploaded successfully!');
});
app.listen(3000, () => console.log('Server running on port 3000'));
프로덕션 애플리케이션의 경우 파일을 클라우드 스토리지(예: AWS S3)에 직접 저장하는 것이 더 나은 경우가 많습니다. S3와 통합하려면 multer-s3을 사용하세요.
const storage = multer.diskStorage({
destination: (req, file, cb) => cb(null, 'uploads/'), // Folder location
filename: (req, file, cb) => {
const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1E9);
cb(null, uniqueSuffix + '-' + file.originalname);
}
});
const upload = multer({ storage: storage });
const upload = multer({ storage: multer.memoryStorage() });
이 설정은 로컬 저장소를 거치지 않고 지정된 S3 버킷에 직접 파일을 업로드합니다.
유형별로 파일을 필터링하여 특정 파일 형식(예: 이미지)만 허용할 수 있습니다. fileFilter 옵션을 사용하세요.
npm install aws-sdk multer-s3
대용량 파일이 업로드되는 것을 방지하려면 제한 옵션을 설정하세요. 파일 크기를 1MB로 제한하는 방법은 다음과 같습니다.
const aws = require('aws-sdk');
const multerS3 = require('multer-s3');
aws.config.update({ region: 'your-region' });
const s3 = new aws.S3();
const upload = multer({
storage: multerS3({
s3: s3,
bucket: 'your-s3-bucket-name',
metadata: (req, file, cb) => cb(null, { fieldName: file.fieldname }),
key: (req, file, cb) => cb(null, Date.now().toString() + '-' + file.originalname)
})
});
Multer는 다중 파일 업로드도 지원합니다.
const fileFilter = (req, file, cb) => {
// Accept only image files
if (file.mimetype.startsWith('image/')) {
cb(null, true); // Accept file
} else {
cb(new Error('Only image files are allowed!'), false); // Reject file
}
};
const upload = multer({
storage: storage,
fileFilter: fileFilter
});
원활한 사용자 경험을 위해서는 적절한 오류 처리가 중요합니다. Multer는 다음과 같이 처리할 수 있는 여러 유형의 오류를 발생시킬 수 있습니다.
const upload = multer({
storage: storage,
limits: { fileSize: 1 * 1024 * 1024 } // 1 MB limit
});
다음은 Multer를 사용하기 위한 실제 애플리케이션입니다.
Multer는 유연한 저장 옵션, 파일 필터링을 제공하고 단일 파일에서 여러 파일에 이르기까지 다양한 업로드 요구 사항을 처리하여 Node.js 애플리케이션에서 파일 처리를 단순화합니다. 소규모 앱을 구축하든 파일 처리가 필요한 프로덕션 수준 애플리케이션을 구축하든 Multer가 도와드립니다.
즐거운 코딩하세요! ?
위 내용은 Multer를 사용하여 Node.js에서 파일 업로드 처리: 종합 가이드의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!
![[웹 프런트엔드] Node.js 빠른 시작](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
