Web 開発の世界では、ファイルのアップロードを処理することが一般的な要件です。プロフィール写真、ドキュメント、画像のいずれであっても、多くのアプリケーションはファイルを安全かつ効率的にアップロードして保存する必要があります。 Express で Node.js を使用する場合、Multer は、このタスクをスムーズに処理するために利用できる最良のライブラリの 1 つです。
このブログでは、インストール、構成、ストレージ オプション、ファイル フィルタリング、コード例を含む一般的な使用例など、Node.js での Multer の使用について知っておくべきことをすべて説明します。
Multer は、Web アプリケーションでファイルをアップロードするために一般的に使用される形式である 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 は 2 つの主要なストレージ オプションを提供します:
ディスク ストレージを使用すると、ファイルの名前と宛先パスをより詳細に制御できます。
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 中国語 Web サイトの他の関連記事を参照してください。
![[Web フロントエンド] Node.js クイック スタート](https://img.php.cn/upload/course/000/000/067/662b5d34ba7c0227.png)
