DIV CSS 佈局教程網

用 Node.js 手動組 multipart 內容模擬檔案上傳
編輯:JavaScript綜合知識     

要在 Node.js 中把檔案 POST 到別人的伺服器,除了用現成套件,也可以自己動手組 multipart/form-data。這麼做的好處是徹底理解協定的每一個位元組,也方便在沒有套件的環境中實作。

multipart 格式長什麼樣

請求本文由「邊界(boundary)」分隔成多個部分,每個部分開頭是一段標頭,接著空行,再來才是內容:

------WebKitFormBoundaryuzKmkAovUuYsQ1Dt
Content-Disposition: form-data; name="file"; filename="00.jpg"
Content-Type: application/octet-stream

(此處是檔案的位元組內容)
------WebKitFormBoundaryuzKmkAovUuYsQ1Dt
Content-Disposition: form-data; name="fieldName"

(此處是一般欄位的值)
------WebKitFormBoundaryuzKmkAovUuYsQ1Dt--

注意每個換行都是 \r\n,最後一個邊界後面還要多兩個 -- 表示結束。這些細節錯一個位元組,伺服器就會解析失敗。

逐段拆解實作

var path = require("path");
var fs   = require("fs");
var http = require("http");
var https = require("https");

// 一般文字欄位
var getfield = function (field, value) {
  return 'Content-Disposition: form-data; name="' + field + '"\r\n\r\n' + value + '\r\n';
};

// 檔案欄位的標頭
var getfieldHead = function (field, filename) {
  return 'Content-Disposition: form-data; name="' + field + '"; filename="'
       + filename + '"\r\n'
       + 'Content-Type: ' + getMime(filename) + '\r\n\r\n';
};

// 依副檔名判斷 MIME
var getMime = function (filename) {
  var mimes = {
    '.png': 'image/png',
    '.gif': 'image/gif',
    '.jpg': 'image/jpeg',
    '.jpeg': 'image/jpeg',
    '.js': 'application/javascript',
    '.json': 'application/json',
    '.torrent': 'application/octet-stream'
  };
  var mime = mimes[path.extname(filename).toLowerCase()];
  return mime || 'application/octet-stream';
};

// 產生隨機邊界字串
var getBoundary = function () {
  return Math.random().toString(36).slice(2);
};

var getBoundaryBorder = function (boundary) {
  return '--' + boundary + '\r\n';
};

// 把所有文字欄位組成一整段
function fieldPayload(opts) {
  var payload = [];
  for (var id in opts.field) {
    payload.push(getfield(id, opts.field[id]));
  }
  payload.push("");
  return payload.join(getBoundaryBorder(opts.boundary));
}

讀檔並送出請求

// 以串流方式讀檔,合併成 Buffer 後交給回呼
function filereadstream(opts, fn) {
  var readstream = fs.createReadStream(opts.file, { flags: 'r', encoding: null });
  var chunks = [];
  var length = 0;

  readstream.on('data', function (chunk) {
    length += chunk.length;
    chunks.push(chunk);
  });

  readstream.on('end', function () {
    var buffer = Buffer.alloc(length);      // 新版請用 Buffer.alloc
    var pos = 0;
    for (var i = 0; i < chunks.length; i++) {
      chunks[i].copy(buffer, pos);
      pos += chunks[i].length;
    }
    fn(buffer);
  });
}

function postRequest(opts) {
  filereadstream(opts, function (buffer) {
    var options = require('url').parse(opts.url);
    var h = getBoundaryBorder(opts.boundary);   // 起始邊界
    var e = fieldPayload(opts);                 // 文字欄位
    var a = getfieldHead(opts.param, path.basename(opts.file));  // 檔案標頭
    var d = "\r\n" + h.replace(/\r\n$/, '--\r\n');             // 結束邊界

    var headers = {};
    headers["Content-Length"] = Buffer.byteLength(h + e + a) + buffer.length + Buffer.byteLength(d);
    headers["Content-Type"] = 'multipart/form-data; boundary=' + opts.boundary;

    options.headers = headers;
    options.method = 'POST';

    var client = options.protocol === 'https:' ? https : http;
    var req = client.request(options, function (res) {
      var data = '';
      res.on('data', function (chunk) { data += chunk; });
      res.on('end', function () {
        console.log(res.statusCode);
        console.log(data);
      });
    });

    req.on('error', function (err) { console.error(err); });

    req.write(h + e + a);
    req.write(buffer);
    req.end(d);
  });
}

// 使用方式
var opt = {
  "url": "https://xxxx.xx",                     // 目標網址
  "file": "00.jpg",                            // 檔案路徑
  "param": "file",                             // 檔案欄位名稱
  "field": {                                   // 其餘要一起送出的欄位
    "client": "1",
    "title": "ok"
  },
  "boundary": "----WebKitFormBoundary" + getBoundary()
};

postRequest(opt);

幾個實務上的坑

  • Content-Length 必須是位元組數:中文欄位用 Buffer.byteLength() 計算,不能用 str.length,否則長度不符會導致 hangs 或截斷。
  • 換行一定是 \r\n:用 \n 大多數伺服器會直接拒絕。
  • 檔案要當二進位處理:讀檔時 encoding 必須是 null,若指定 utf-8 會破壞圖片。
  • Buffer 建構子已棄用:舊寫法 new Buffer(length) 請改用 Buffer.alloc(length)。
  • HTTPS:依網址協定選擇 http 或 https 模組,別寫死。

當然,實務上請用套件

除非你就是想理解協定,正式專案建議直接用成熟套件,它會幫你處理邊界、串流與錯誤:

const fs = require('fs');
const FormData = require('form-data');
const fetch = require('node-fetch');   // Node 18+ 可直接用全域 fetch

const form = new FormData();
form.append('client', '1');
form.append('title', 'ok');
form.append('file', fs.createReadStream('00.jpg'));

fetch('https://xxxx.xx', { method: 'POST', body: form })
  .then(r => r.text())
  .then(console.log);

Node 18 之後內建的 FormData 與 fetch 已能勝任,連額外套件都省了。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved