multer Middleware

Multer ist eine Middleware von node.js für den Umgang mit multipart/form-data, die hauptsächlich zum Hochladen von Dateien verwendet wird. Es wird oben auf busboy geschrieben, um maximale Effizienz zu erzielen.

HINWEIS: Multer wird keine Form verarbeiten, die nicht multipart ist (multipart/form-data).

Übersetzungen

Diese README ist auch in anderen Sprachen verfügbar:

Installation

$ npm install multer

Auslastung

Multer fügt dem request Objekt ein body und ein file oder files Objekt hinzu. Das body Objekt enthält die Werte der Textfelder der Form, das file oder files Objekt enthält die Dateien, die über das Formular hochgeladen werden.

Einfaches Nutzungsbeispiel:

Vergessen Sie nicht die enctype="multipart/form-data" in Ihrem Formular.

<form action="/profile" method="post" enctype="multipart/form-data">
  <input type="file" name="avatar" />
</form>

const express = require('express');
const multer = require('multer');
const upload = multer({ dest: 'uploads/' });

const app = express();

app.post('/profile', upload.single('avatar'), function (req, res, next) {
  // req.file is the `avatar` file
  // req.body will hold the text fields, if there were any
});

app.post('/photos/upload', upload.array('photos', 12), function (req, res, next) {
  // req.files is array of `photos` files
  // req.body will contain the text fields, if there were any
});

const uploadMiddleware = upload.fields([
  { name: 'avatar', maxCount: 1 },
  { name: 'gallery', maxCount: 8 },
]);
app.post('/cool-profile', uploadMiddleware, function (req, res, next) {
  // req.files is an object (String -> Array) where fieldname is the key, and the value is array of files
  //
  // e.g.
  //  req.files['avatar'][0] -> File
  //  req.files['gallery'] -> Array
  //
  // req.body will contain the text fields, if there were any
});

Falls du ein text-only mehrteiliges Formular bearbeiten musst, solltest du die .none() Methode verwenden:

const express = require('express');
const app = express();
const multer = require('multer');
const upload = multer();

app.post('/profile', upload.none(), function (req, res, next) {
  // req.body contains the text fields
});

Hier ist ein Beispiel dafür, wie Multer in einem HTML-Formular verwendet wird. Achte besonders auf die Felder enctype="multipart/form-data" und name="uploaded_file" :

<form action="/stats" enctype="multipart/form-data" method="post">
  <div class="form-group">
    <input type="file" class="form-control-file" name="uploaded_file" />
    <input type="text" class="form-control" placeholder="Number of speakers" name="nspeakers" />
    <input type="submit" value="Get me the stats!" class="btn btn-default" />
  </div>
</form>

Dann in Ihrer Javascript-Datei würden Sie diese Zeilen hinzufügen, um sowohl auf die Datei als auch den Körper. Es ist wichtig, dass du den Wert des Feldes name aus dem Formular in deiner Upload-Funktion benutzt. Dies teilt dem Multer mit, in welchem Feld er nach den Dateien suchen soll. Wenn diese Felder im HTML-Formular und auf Ihrem Server nicht identisch sind, wird Ihr Upload fehlschlagen:

const multer = require('multer');
const upload = multer({ dest: './public/data/uploads/' });
app.post('/stats', upload.single('uploaded_file'), function (req, res) {
  // req.file is the name of your file in the form above, here 'uploaded_file'
  // req.body will hold the text fields, if there were any
  console.log(req.file, req.body);
});

API

Dateiinformation

Jede Datei enthält folgende Informationen:

multer(opts)

Multer akzeptiert ein Optionsobjekt, dessen grundlegendste die Eigenschaft dest ist, die Multer anweist, wo die Dateien hochgeladen werden sollen. Falls Sie das Optionsobjekt weglassen, werden die Dateien im Speicher gespeichert und nie auf die Festplatte geschrieben.

Standardmäßig wird Multer die Dateien umbenennen, um Konflikte zu vermeiden. Die Umbenennungsfunktion kann an Ihre Bedürfnisse angepasst werden.

Die folgenden Optionen können an Multer übergeben werden.

In einer durchschnittlichen Web-App könnte nur dest erforderlich sein, und konfiguriert werden, wie in das folgende Beispiel.

const upload = multer({ dest: 'uploads/' });

Wenn du mehr Kontrolle über deine Uploads haben möchtest, möchtest du die Option storage anstelle von dest verwenden. Multerschiffe mit Speichermotoren DiskStorage und MemoryStorage; Weitere Motoren sind von Dritten erhältlich.

.single(Feldname)

Akzeptieren Sie eine einzelne Datei mit dem Namen Feldname. Die einzelne Datei wird in req.file gespeichert.

.array(Feldname[, maxCount])

Akzeptieren Sie ein Array von Dateien, alle mit dem Namen Feldname. Optionaler Fehler wenn mehr als maxCount-Dateien hochgeladen werden. Das Array der Dateien wird in req.files gespeichert.

.fields(fields)

Akzeptieren Sie einen Mix von Dateien, angegeben durch fields. Ein Objekt mit Arrays von Dateien wird in req.files gespeichert.

fields sollte ein Array von Objekten mit name und optional ein maxCount sein. Beispiel:

[
  { name: 'avatar', maxCount: 1 },
  { name: 'gallery', maxCount: 8 },
];

.none()

Nur Textfelder akzeptieren. Wenn eine Datei hochgeladen wurde, wird ein Fehler mit dem Code “LIMIT_UNEXPECTED_FILE” ausgelöst.

.any()

Akzeptiert alle Dateien, die über das Kabel kommen. Ein Array von Dateien wird in req.files gespeichert.

WARNUNG: Stellen Sie sicher, dass Sie immer die Dateien behandeln, die ein Benutzer hochlädt. Fügen Sie Multer nie als globale Middleware hinzu, da ein böswilliger Benutzer Dateien zu einer Route hochladen konnte, die Sie nicht erwartet haben. Verwenden Sie diese Funktion nur auf Routen , wo Sie die hochgeladenen Dateien behandeln.

”Speicher”

DiskStorage

Die Festplattenspeicher-Engine gibt Ihnen die volle Kontrolle über die Speicherung von Dateien auf der Festplatte.

const storage = multer.diskStorage({
  destination: function (req, file, cb) {
    cb(null, '/tmp/my-uploads');
  },
  filename: function (req, file, cb) {
    const uniqueSuffix = Date.now() + '-' + Math.round(Math.random() * 1e9);
    cb(null, file.fieldname + '-' + uniqueSuffix);
  },
});

const upload = multer({ storage: storage });

Es sind zwei Optionen verfügbar, destination und filename. Es sind beide -Funktionen, die bestimmen, wo die Datei gespeichert werden soll.

destination wird verwendet, um festzustellen, in welchem Ordner die hochgeladenen Dateien gespeichert werden sollen. Dies kann auch als string angegeben werden (z.B. '/tmp/uploads'). Wenn kein destination angegeben wird, wird das Standardverzeichnis des Betriebssystems für temporäre Dateien verwendet.

Hinweis: Du bist für das Erstellen des Verzeichnisses verantwortlich, wenn du destination als Funktion bereitstellst. Wenn Sie einen String übergeben, wird der Multer sicherstellen, dass das Verzeichnis für Sie erstellt wird.

filename wird verwendet, um zu bestimmen, welche Datei im Ordner benannt werden soll. Wenn kein Dateiname angegeben wird, erhält jede Datei einen zufälligen Namen, der keine Dateiendung enthält.

Hinweis: Multer wird keine Dateiendung für Sie anhängen, Ihre Funktion sollte einen Dateinamen mit einer Dateiendung zurückgeben.

Jede Funktion wird sowohl die Anfrage (req) als auch einige Informationen über die Datei (file) übergeben, um die Entscheidung zu unterstützen.

Beachte, dass req.body möglicherweise noch nicht vollständig besiedelt ist. Es hängt von der Reihenfolge ab, dass der Client Felder und Dateien an den Server überträgt.

Um die im Callback verwendete Aufrufkonvention zu verstehen (muss Null als erster Parameter übergeben werden), lesen Sie bitte Node. s Fehlerbehandlung

MemoryStorage

Die Speicher-Engine speichert die Dateien im Speicher als Buffer Objekte. Es hat keine Optionen.

const storage = multer.memoryStorage();
const upload = multer({ storage: storage });

Wenn Sie Speicher verwenden, enthält die Datei-Info ein Feld mit dem Namen buffer, das die gesamte Datei enthält.

WARNUNG: Hochladen sehr großer Dateien oder relativ kleiner Dateien in großen -Zahlen sehr schnell kann dazu führen, dass Ihre Anwendung bei Verwendung des Arbeitsspeichers nicht mehr genügend Speicher hat.

Limits

Ein Objekt, das die Größengrenzen der folgenden optionalen Eigenschaften angibt. Multer übergibt dieses Objekt direkt an den Busboy und die Details der Eigenschaften finden Sie auf Busboys Seite.

Die folgenden Ganzzahlwerte sind verfügbar:

Die Angabe der Grenzwerte kann dazu beitragen, Ihre Website vor Denial of Service (DoS) Attacken zu schützen.

”fileFilter”

Setze dies auf eine Funktion um zu kontrollieren, welche Dateien hochgeladen werden sollen und welche übersprungen werden soll. Die Funktion sollte so aussehen:

function fileFilter(req, file, cb) {
  // The function should call `cb` with a boolean
  // to indicate if the file should be accepted

  // To reject this file pass `false`, like so:
  cb(null, false);

  // To accept the file pass `true`, like so:
  cb(null, true);

  // You can always pass an error if something goes wrong:
  cb(new Error("I don't have a clue!"));
}

Fehlerbehandlung

Wenn ein Fehler auftritt, wird Multer den Fehler an Express übertragen. Du kannst eine schöne Fehlerseite anzeigen, indem du den Standard-Express-Weg.

Wenn Sie Fehler speziell von Multer auffangen möchten, können Sie die Middleware-Funktion selbst aufrufen. Außerdem, wenn du nur [die Multer-Fehler] fangen möchtest (https://github.com/expressjs/multer/blob/main/lib/multer-error.js), du kannst die MulterError Klasse verwenden, die an das multer Objekt selbst angeschlossen ist (e. . err instancemulter.MulterError`).

const multer = require('multer');
const upload = multer().single('avatar');

app.post('/profile', function (req, res) {
  upload(req, res, function (err) {
    if (err instanceof multer.MulterError) {
      // A Multer error occurred when uploading.
    } else if (err) {
      // An unknown error occurred when uploading.
    }

    // Everything went fine.
  });
});

Eigene Speicher-Engine

Informationen zum Aufbau Ihrer eigenen Speicher-Engine finden Sie unter Multer Storage Engine.

Lizenz

MIT