Toidicode.com

Toidicode.com

BASIC TO ADVANCE

Bài 18: Upload file với Multer trong Express

Ở bài trước MiniBlog đã có các lớp bảo vệ, nhưng bài viết vẫn chỉ có chữ. Tiếp tục với series, bài này mình sẽ giới thiệu với mọi người về upload file với Multer trong Express để thêm ảnh đại diện cho bài viết.

1. Multer là gì?

Form có ô chọn file phải gửi với enctype="multipart/form-data", kiểu body mà express.urlencoded() (Bài 10) không đọc. Multer (trong danh sách middleware của Express) đọc kiểu body này: các ô chữ vào req.body, file vào req.file. Bản hiện tại là 2.5.0:

npm install multer

Cột cover của bảng posts đã có từ Bài 12, chúng ta lưu đường dẫn ảnh vào đó.

2. Cấu hình multer.

Multer có hai storage: diskStorage ghi file ra đĩa ngay khi nhận, memoryStorage giữ file trong RAM (file.buffer). CSRF và validation chạy sau multer (phần 3), nên mình dùng memoryStorage: form sai thì chưa có file nào trên đĩa để dọn. Đổi lại phải giới hạn dung lượng thật chặt.

- middlewares/upload.js

import multer from 'multer';
import HttpError from '../lib/http-error.js';
import { IMAGE_TYPES } from '../lib/uploads.js';

const upload = multer({
    // File nằm trong RAM, chưa ghi ra đĩa
    storage: multer.memoryStorage(),
    limits: {
        fileSize: 2 * 1024 * 1024, // mỗi file tối đa 2 MB
        files: 1, // chỉ một file
        fields: 10, // số ô dữ liệu thường
        fieldSize: 50 * 1024, // mỗi ô tối đa 50 KB
    },
    // Chỉ nhận JPG, PNG, WebP
    fileFilter(req, file, cb) {
        if (IMAGE_TYPES[file.mimetype]) {
            return cb(null, true);
        }
        cb(new HttpError(422, 'Ảnh đại diện chỉ nhận file JPG, PNG hoặc WebP'));
    },
});

const single = upload.single('cover');

// Đọc form multipart: các ô vào req.body, ảnh (ô cover) vào req.file
export function uploadCover(req, res, next) {
    single(req, res, (err) => {
        if (err?.code === 'LIMIT_FILE_SIZE') {
            return next(new HttpError(413, 'Ảnh đại diện tối đa 2 MB'));
        }
        // Lỗi khác của multer, body hỏng hay bị cắt giữa chừng đều do client gửi sai
        if (err && !(err instanceof HttpError)) {
            return next(new HttpError(400, 'Dữ liệu gửi lên không hợp lệ'));
        }
        next(err);
    });
}

Trong đó:

  • upload.single('cover') nhận đúng một file từ ô name="cover", file ở ô khác hay file thứ hai đều bị báo lỗi.
  • limits chống tấn công DoS, tài liệu multer khuyên luôn đặt.
  • Lỗi của multer (MulterError, tiếng Anh) và lỗi body multipart hỏng (VD: Unexpected end of form) được đổi thành HttpError (Bài 7) 413 hoặc 400, vì đó là lỗi của client chứ không phải lỗi server 500. Lỗi 422 của fileFilter giữ nguyên.

Chú ý: Tài liệu multer cảnh báo không dùng multer cho cả ứng dụng (app.use()), chỉ gắn vào route cần upload.

3. Thứ tự multer và kiểm tra CSRF.

csrfProtection ở Bài 17 đọc token trong req.body._csrf, mà với form multipart thì chỉ sau multer req.body mới có. Vậy multer phải đứng trước nó, gắn vào đúng hai route ghi bài:

- app.js (đoạn thay đổi)

import { loadUser, requireAuth } from './middlewares/auth.js';
import { uploadCover } from './middlewares/upload.js';

// ...
app.use(loadUser);

// Form bài viết gửi kèm ảnh (multipart/form-data): phải đăng nhập, rồi multer đọc body
// trước để csrfProtection thấy được req.body._csrf
app.post('/posts', requireAuth, uploadCover);
app.put('/posts/:id', requireAuth, uploadCover);

// Request ghi dữ liệu (POST, PUT, DELETE) phải gửi kèm token CSRF đúng
app.use(csrfProtection);

Thứ tự lúc này: requireAuth (chưa đăng nhập thì multer không đọc byte nào), uploadCover, csrfProtection, rồi postRules và controller trong routes/posts.js (không đổi). Sai token hay sai dữ liệu thì file trong RAM bị bỏ đi. app.put() khớp được form sửa vì method override chạy trước. Request multipart tới route khác không có token nên vẫn bị chặn 403.

Lỗi multer xảy ra trước khi có res.locals.csrfToken, nên trong partials/header.ejs các bạn đổi ô token của form đăng xuất thành value="<%= locals.csrfToken?.() %>" để trang lỗi không hỏng.

4. Lưu ảnh với tên ngẫu nhiên và phục vụ ảnh.

Tên file người dùng gửi (file.originalname) có thể trùng hoặc chứa ../, nên mình đặt tên bằng randomUUID() với đuôi theo loại ảnh:

- lib/uploads.js

import { randomUUID } from 'node:crypto';
import fs from 'node:fs/promises';
import path from 'node:path';

// Ảnh upload nằm trong public/ để express.static phục vụ
export const UPLOAD_DIR = path.join(import.meta.dirname, '../public/uploads');

// Loại ảnh được nhận và đuôi file tương ứng
export const IMAGE_TYPES = {
    'image/jpeg': '.jpg',
    'image/png': '.png',
    'image/webp': '.webp',
};

// Ghi ảnh ra đĩa với tên ngẫu nhiên, trả về URL để lưu vào cột cover
export async function saveImage(file) {
    const name = randomUUID() + IMAGE_TYPES[file.mimetype];
    await fs.mkdir(UPLOAD_DIR, { recursive: true });
    await fs.writeFile(path.join(UPLOAD_DIR, name), file.buffer);
    return `/uploads/${name}`;
}

// Xoá ảnh theo URL đã lưu (không có thì bỏ qua)
export async function removeImage(url) {
    if (!url) {
        return;
    }
    await fs.rm(path.join(UPLOAD_DIR, path.basename(url)), { force: true });
}

express.static() (Bài 9) phục vụ luôn ảnh ở /uploads/.... Các bạn thêm public/uploads/ vào .gitignore. Service chỉ ghi ảnh khi controller gọi, tức là sau mọi kiểm tra:

- services/post-service.js (đoạn thay đổi, import thêm { saveImage, removeImage })

export async function createPost({ title, content, authorId = null, coverFile = null }) {
    const slug = slugify(title);
    const cover = coverFile ? await saveImage(coverFile) : null;
    try {
        await Post.create({ title, slug, content, cover, authorId });
    } catch (err) {
        await removeImage(cover); // lưu bài lỗi thì xoá ảnh vừa ghi
        throw err;
    }
    return slug;
}
  • models/post.js: create(), update() thêm cột cover; store trong controller truyền thêm coverFile: req.file.
  • posts/form.ejs: <form> thêm enctype="multipart/form-data" và ô <input type="file" name="cover" accept="image/jpeg,image/png,image/webp">. Form báo lỗi thì phải chọn lại ảnh, trình duyệt không điền sẵn ô file.
  • posts/show.ejs: có post.cover thì hiện <img src="<%= post.cover %>" alt="<%= post.title %>" class="post-cover"> (CSS max-width: 100%).

Lưu ý: mimetype do trình duyệt gửi nên có thể giả, nhưng file luôn mang đuôi ảnh và helmet gửi nosniff nên trình duyệt không chạy nó như HTML. Muốn chắc hơn thì dùng package file-type.

5. Xoá file và thử upload.

Đổi ảnh hay xoá bài thì phải xoá file cũ:

- services/post-service.js (đoạn thay đổi)

// Có ảnh mới thì ghi ảnh mới, cập nhật bài rồi xoá ảnh cũ
export async function updatePost(post, { title, content, coverFile = null }) {
    const cover = coverFile ? await saveImage(coverFile) : post.cover;
    try {
        await Post.update(post.id, { title, content, cover });
    } catch (err) {
        if (coverFile) {
            await removeImage(cover); // cập nhật lỗi thì xoá ảnh mới vừa ghi
        }
        throw err;
    }
    if (cover !== post.cover) {
        await removeImage(post.cover);
    }
}

// Xoá bài viết thì xoá luôn ảnh đại diện
export async function deletePost(post) {
    ensureFound(await Post.remove(post.id));
    await removeImage(post.cover);
}

Controller: update gọi updatePost(post, { ...matchedData(req), coverFile: req.file }), destroy gọi deletePost(post). database/seed.js import fs (node:fs/promises), UPLOAD_DIR và thêm await fs.rm(UPLOAD_DIR, { recursive: true, force: true }); sau câu ALTER TABLE để xoá cả ảnh.

Giờ thử nào. Chạy npm run dev, chép một ảnh PNG vào thư mục MiniBlog với tên anh.png, rồi đăng nhập bằng tài khoản ở Bài 16. Trang /posts/new có hai ô _csrf nên chỉ lấy dòng đầu:

TOKEN=$(curl -s -c cookies.txt http://localhost:3000/login | sed -n 's/.*name="_csrf" value="\([^"]*\)".*/\1/p')
curl -s -o /dev/null -b cookies.txt -c cookies.txt --data-urlencode "_csrf=$TOKEN" --data-urlencode '[email protected]' --data-urlencode 'password=matkhau123' http://localhost:3000/login
# Token đổi sau khi đăng nhập nên lấy lại
TOKEN=$(curl -s -b cookies.txt http://localhost:3000/posts/new | sed -n 's/.*name="_csrf" value="\([^"]*\)".*/\1/p' | head -n 1)

curl -s -o /dev/null -w '%{http_code} %{redirect_url}\n' -b cookies.txt -F "_csrf=$TOKEN" -F 'title=Upload file với Multer' -F 'content=Thêm ảnh đại diện cho bài viết bằng multer.' -F '[email protected]' http://localhost:3000/posts
# 303 http://localhost:3000/posts/upload-file-voi-multer
ls public/uploads
# f0214398-add5-456b-a35e-7a09a1a3f217.png

Mở trang bài viết sẽ thấy ảnh. Thử các trường hợp bị từ chối (curl đoán kiểu file theo đuôi):

head -c 3000000 /dev/zero > lon.png
curl -s -w ' %{http_code}\n' -b cookies.txt -F "_csrf=$TOKEN" -F '[email protected]' http://localhost:3000/posts
# {"message":"Ảnh đại diện tối đa 2 MB"} 413
curl -s -w ' %{http_code}\n' -b cookies.txt -F "_csrf=$TOKEN" -F '[email protected]' http://localhost:3000/posts
# {"message":"Ảnh đại diện chỉ nhận file JPG, PNG hoặc WebP"} 422
curl -s -w ' %{http_code}\n' -b cookies.txt -F '[email protected]' http://localhost:3000/posts
# {"message":"Form đã hết hạn, vui lòng tải lại trang và thử lại"} 403

public/uploads vẫn chỉ có một file. Thử xong các bạn xoá anh.png, lon.png, cookies.txt và chạy npm run db:seed để đưa bài viết về ban đầu (ảnh cũng bị xoá).

Code đầy đủ của MiniBlog sau bài này nằm ở tag bai-18 trên GitHub; các thay đổi của riêng bài này: so sánh bai-17...bai-18.

6. Lời kết.

Như vậy là chúng ta đã làm xong upload file với Multer trong Express: giới hạn file, đặt multer trước kiểm tra CSRF, lưu ảnh với tên ngẫu nhiên, phục vụ và xoá ảnh. Bài sau mình sẽ giới thiệu với mọi người về cách xây dựng REST API với Express cho MiniBlog.

Đăng ký nhận tin.

Chúng tôi chỉ gửi tối đa 2 lần trên 1 tháng. Tuyên bố không spam mail!

Vũ Thanh Tài

About author
The best way to learn is to share
Xem tất cả bài đăng

0 Comments

Bài viết chưa có ai bình luận, hãy là người đầu tiên đi bạn!

Bình luận

Captcha