In der Welt der Webentwicklung ist der Umgang mit Datei-Uploads eine h?ufige Anforderung. Ob Profilbilder, Dokumente oder Bilder – viele Anwendungen müssen Dateien sicher und effizient hochladen und speichern. Bei der Verwendung von Node.js mit Express ist Multer eine der besten verfügbaren Bibliotheken, um diese Aufgabe reibungslos zu bew?ltigen.

In diesem Blog behandeln wir alles, was Sie über die Verwendung von Multer in Node.js wissen müssen, einschlie?lich Installation, Konfiguration, Speicheroptionen, Dateifilterung und h?ufige Anwendungsf?lle anhand von Codebeispielen.

Inhaltsverzeichnis

1. Was ist Multer?
2. Installation
3. Multer mit Express einrichten
4. Speicheroptionen verstehen
   • Festplattenspeicher
   • Speicher
   • Cloud-Speicher (S3-Beispiel)
5. Dateien nach Typ filtern
6. Dateigr??e begrenzen
7. Verwaltung mehrerer Datei-Uploads
8. Fehlerbehandlung in Multer
9. Anwendungsf?lle aus der Praxis
10. Fazit

Was ist Multer?

Multer ist eine Middleware für die Verarbeitung von Multipart-/Formulardaten, einem h?ufig verwendeten Format zum Hochladen von Dateien in Webanwendungen. Es wurde speziell für die Zusammenarbeit mit Express entwickelt und hilft bei der Verwaltung von Datei-Uploads, indem es Folgendes bietet:

• Dateispeicherung: Konfigurierbare Speicheroptionen zum Speichern von Dateien auf dem Server oder anderen Speicherdiensten.
• Dateifilterung: Erm?glicht das Festlegen von Einschr?nkungen für Dateitypen.
• Gr??enbegrenzung: Hilft bei der Begrenzung der Dateigr??e, um überm??ige Daten-Uploads zu verhindern.

Installation

Um mit Multer zu beginnen, installieren Sie es über npm:

npm install multer

Multer mit Express einrichten

Beginnen wir mit der Einrichtung eines einfachen Datei-Upload-Handlers mit Multer in einer Express-Anwendung. So fangen Sie an:

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'));

In diesem Beispiel:

• upload.single('file'): Diese Middleware verarbeitet eine einzelne Datei, die mit der Schlüsseldatei hochgeladen wurde.
• Hochgeladene Dateien werden im Ordner ?uploads/“ gespeichert.

Speicheroptionen verstehen

Multer bietet zwei prim?re Speicheroptionen:

1. Festplattenspeicher: Speichert Dateien lokal auf dem Server.
2. Speicher: Speichert Dateien im Speicher als Pufferobjekte (nützlich für die Verarbeitung von Dateien im Speicher).

1. Festplattenspeicher

Festplattenspeicher bietet mehr Kontrolle über Dateinamen und Zielpfade.

npm install multer

• Ziel: Gibt den Ordner für Datei-Uploads an.
• Dateiname: Erm?glicht die Anpassung des Dateinamens (z. B. Hinzufügen eines Zeitstempels zur Eindeutigkeit).

2. Speicher

Im Arbeitsspeicher werden Dateien als Puffer gespeichert, was für kurzlebige Dateien oder zum Bearbeiten von Uploads nützlich ist, ohne Dateien auf der Festplatte zu speichern.

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'));

Cloud-Speicher: Multer mit AWS S3

Für Produktionsanwendungen ist die direkte Speicherung von Dateien im Cloud-Speicher (wie AWS S3) oft vorzuziehen. Zur Integration mit S3 verwenden Sie 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() });

Dieses Setup l?dt Dateien direkt in den angegebenen S3-Bucket hoch und umgeht dabei den lokalen Speicher.

Dateien nach Typ filtern

Sie k?nnen Dateien nach Typ filtern, um nur bestimmte Dateiformate (z. B. Bilder) zu akzeptieren. Verwenden Sie die Option fileFilter.

npm install aws-sdk multer-s3

Begrenzung der Dateigr??e

Um zu verhindern, dass gro?e Dateien hochgeladen werden, legen Sie eine Begrenzungsoption fest. So begrenzen Sie die Dateigr??e auf 1 MB:

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)
  })
});

Umgang mit mehreren Datei-Uploads

Multer unterstützt auch das Hochladen mehrerer Dateien:

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
});

• upload.array('files', 5): Erm?glicht das Hochladen von bis zu 5 Dateien unter demselben Feld.
• upload.fields: Erm?glicht die Verarbeitung von Dateien mit unterschiedlichen Feldnamen.

Fehlerbehandlung in Multer

Die richtige Fehlerbehandlung ist entscheidend für ein reibungsloses Benutzererlebnis. Multer kann verschiedene Arten von Fehlern ausl?sen, die Sie wie folgt behandeln k?nnen:

const upload = multer({
  storage: storage,
  limits: { fileSize: 1 * 1024 * 1024 } // 1 MB limit
});

Anwendungsf?lle aus der Praxis

Hier sind einige reale Anwendungen für die Verwendung von Multer:

1. Profilbild-Upload: Erm?glicht Benutzern das Hochladen von Profilbildern, deren Speicherung auf dem Server oder in S3 und das Speichern des Dateipfads in einer Datenbank.
2. Dokumentenspeicher: Speichern Sie vom Benutzer eingereichte Dokumente (z. B. Lebensl?ufe, PDFs) mit benutzerdefinierten Speicher- und Filterkonfigurationen.
3. Mediendateien im E-Commerce: Erm?glichen Sie Anbietern das Hochladen von Produktbildern, beschr?nken Sie die Dateitypen und -gr??en und speichern Sie sie zum einfachen Abrufen im Cloud-Speicher.

Abschluss

Multer vereinfacht die Dateiverwaltung in Node.js-Anwendungen durch die Bereitstellung flexibler Speicheroptionen, Dateifilterung und die Handhabung verschiedener Upload-Anforderungen, von einzelnen Dateien bis hin zu mehreren Dateien. Egal, ob Sie eine kleine App oder eine Anwendung auf Produktionsebene mit Dateiverwaltungsanforderungen erstellen, bei Multer sind Sie an der richtigen Adresse.

Viel Spa? beim Codieren! ?

Das obige ist der detaillierte Inhalt vonUmgang mit Datei-Uploads in Node.js mit Multer: Eine umfassende Anleitung. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!