رفع الملفات في REST API

POST /api/articles HTTP/1.1
Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWx

------WebKitFormBoundary7MA4YWx
Content-Disposition: form-data; name="title"

مقال عن REST
------WebKitFormBoundary7MA4YWx
Content-Disposition: form-data; name="cover"; filename="cover.png"
Content-Type: image/png

<بيانات الصورة الثنائية هون>
------WebKitFormBoundary7MA4YWx--

const form = new FormData();
form.append("title", "مقال عن REST");
form.append("cover", fileInput.files[0]);   // كائن File من <input type="file">

fetch("/api/articles", {
  method: "POST",
  body: form,
  // ⚠️ لا تضبط Content-Type يدويًا — المتصفح بيضيف الـ boundary تلقائيًا
});

npm install multer

import multer from "multer";

const storage = multer.diskStorage({
  destination: (req, file, cb) => cb(null, "uploads/"),
  filename: (req, file, cb) => {
    const unique = Date.now() + "-" + Math.round(Math.random() * 1e9);
    cb(null, unique + "-" + file.originalname);
  },
});

const upload = multer({
  storage,
  limits: { fileSize: 5 * 1024 * 1024 },   // 5 ميغابايت كحد أقصى
  fileFilter: (req, file, cb) => {
    const allowed = ["image/jpeg", "image/png", "image/webp"];
    if (allowed.includes(file.mimetype)) cb(null, true);
    else cb(new Error("نوع ملف غير مدعوم"), false);
  },
});

app.post("/api/articles", upload.single("cover"), (req, res) => {
  const { title } = req.body;       // الحقول النصية
  const file = req.file;            // الملف — fieldname, originalname, mimetype, size, path
  res.status(201).json({ title, coverUrl: `/uploads/${file.filename}` });
});

app.post("/api/gallery", upload.array("photos", 10), (req, res) => {
  const files = req.files;          // مصفوفة ملفات — حتى 10
  res.status(201).json({ count: files.length });
});