Mengendalikan Muat Naik Fail dalam Node.js dengan Multer: Panduan Komprehensif

Dalam dunia pembangunan web, pengendalian muat naik fail adalah keperluan biasa. Sama ada gambar profil, dokumen atau imej, banyak aplikasi perlu memuat naik dan menyimpan fail dengan selamat dan cekap. Apabila menggunakan Node.js dengan Express, Multer ialah salah satu perpustakaan terbaik yang tersedia untuk mengendalikan tugas ini dengan lancar.

Dalam blog ini, kami akan merangkumi semua yang anda perlu ketahui tentang menggunakan Multer dalam Node.js, termasuk pemasangan, konfigurasi, pilihan storan, penapisan fail dan kes penggunaan biasa dengan contoh kod.

---

Jadual Kandungan

1. Apakah Multer?
2. Pemasangan
3. Menyediakan Multer dengan Express
4. Memahami Pilihan Storan
   • Storan Cakera
   • Storan Memori
   • Cloud Storage (contoh S3)
5. Menapis Fail mengikut Jenis
6. Menghadkan Saiz Fail
7. Mengendalikan Muat Naik Berbilang Fail
8. Ralat Pengendalian dalam Multer
9. Kes Penggunaan Dunia Sebenar
10. Kesimpulan

---

Apa itu Multer?

Multer ialah perisian tengah untuk mengendalikan data berbilang bahagian/bentuk, format yang biasa digunakan untuk memuat naik fail dalam aplikasi web. Ia direka khusus untuk berfungsi dengan Express dan membantu dalam menguruskan muat naik fail dengan menyediakan:

• Storan Fail: Pilihan storan boleh dikonfigurasikan untuk menyimpan fail pada pelayan atau perkhidmatan storan lain.
• Penapisan Fail: Membenarkan menetapkan sekatan pada jenis fail.
• Penghadan Saiz: Membantu dalam mengehadkan saiz fail untuk mengelakkan muat naik data yang berlebihan.

Pemasangan

Untuk bermula dengan Multer, pasangkannya melalui npm:

npm install multer

Menyediakan Multer dengan Express

Mari kita mulakan dengan menyediakan pengendali muat naik fail asas menggunakan Multer dalam aplikasi Express. Begini caranya untuk bermula:

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

Dalam contoh ini:

• upload.single('file'): Perisian tengah ini memproses satu fail yang dimuat naik dengan fail utama.
• Fail yang dimuat naik akan disimpan dalam folder muat naik/.

---

Memahami Pilihan Storan

Multer menyediakan dua pilihan storan utama:

1. Storan Cakera: Menyimpan fail secara setempat pada pelayan.
2. Storan Memori: Menyimpan fail dalam ingatan sebagai objek Penampan (berguna untuk memproses fail dalam ingatan).

1. Storan Cakera

Storan cakera memberikan lebih kawalan ke atas penamaan fail dan laluan destinasi.

npm install multer

• destinasi: Menentukan folder untuk muat naik fail.
• nama fail: Membenarkan penyesuaian nama fail (cth., menambahkan cap masa untuk keunikan).

2. Simpanan Memori

Dalam storan memori, fail disimpan sebagai penimbal, yang berguna untuk fail jangka pendek atau untuk mengendalikan muat naik tanpa menyimpan fail ke cakera.

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

Storan Awan: Multer dengan AWS S3

Untuk aplikasi pengeluaran, menyimpan fail terus pada storan awan (seperti AWS S3) selalunya lebih disukai. Untuk menyepadukan dengan S3, gunakan 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() });

Persediaan ini akan memuat naik fail terus ke baldi S3 yang ditentukan, memintas storan setempat.

---

Menapis Fail mengikut Jenis

Anda boleh menapis fail mengikut jenis untuk menerima hanya format fail tertentu (cth., imej). Gunakan pilihan FileFilter.

npm install aws-sdk multer-s3

Mengehadkan Saiz Fail

Untuk menghalang fail besar daripada dimuat naik, tetapkan pilihan had. Begini cara mengehadkan saiz fail kepada 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)
  })
});

Mengendalikan Muat Naik Berbilang Fail

Multer juga menyokong pelbagai muat naik fail:

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): Membenarkan sehingga 5 fail dimuat naik di bawah medan yang sama.
• upload.fields: Mendayakan pengendalian fail dengan nama medan yang berbeza.

---

Pengendalian Ralat dalam Multer

Pengendalian ralat yang betul adalah penting untuk pengalaman pengguna yang lancar. Multer boleh membuang beberapa jenis ralat, yang boleh anda tangani seperti ini:

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

Kes Penggunaan Dunia Sebenar

Berikut ialah beberapa aplikasi dunia sebenar untuk menggunakan Multer:

1. Muat Naik Imej Profil: Benarkan pengguna memuat naik gambar profil, menyimpannya pada pelayan atau dalam S3 dan menyimpan laluan fail dalam pangkalan data.
2. Storan Dokumen: Simpan dokumen yang diserahkan pengguna (cth. resume, PDF) dengan konfigurasi storan dan penapisan tersuai.
3. Fail Media dalam E-dagang: Membolehkan vendor memuat naik imej produk, mengehadkan jenis dan saiz fail serta menyimpannya pada storan awan untuk mendapatkan semula dengan mudah.

Kesimpulan

Multer memudahkan pengendalian fail dalam aplikasi Node.js dengan menyediakan pilihan storan yang fleksibel, penapisan fail dan pengendalian pelbagai keperluan muat naik, daripada fail tunggal kepada berbilang fail. Sama ada anda sedang membina apl kecil atau aplikasi peringkat pengeluaran dengan keperluan pengendalian fail, Multer telah membantu anda.

Selamat Pengekodan! ?

Atas ialah kandungan terperinci Mengendalikan Muat Naik Fail dalam Node.js dengan Multer: Panduan Komprehensif. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!