DIV CSS 佈局教程網

Node.js 如何判定圖片的真實格式:讀取檔案頭而非副檔名
編輯:關於JavaScript     

這是一個實際專案遇到的需求。情境是這樣的:某張圖片真實格式是 JPG,但有人偷懶直接把檔案複製一份、改名成同名的 PNG。這種情況在 AS3 讀取時不會出問題,但手機端 C++ 讀取時卻直接出錯了。

目標

需要寫一支程式,遍歷所有資料夾下的檔案,找出格式「名不符實」的檔案。我們的資源主要是 gif、png、jpg 三種。

第一種做法:自行比對檔案頭

最初我在網上找到一篇講「根據二進位流及檔案頭取得檔案類型 mime-type」的文章,思路是讀取檔案二維內容的頭幾個位元組,取得真實類型,再與副檔名推斷出的類型做比對。

var fd = fs.openSync(new_file_path, 'r');
var buffer = new Buffer(8);

var mineType = mime.lookup(new_file_path);
var fileType = mime.extension(mineType);

fs.readSync(fd, buffer, 0, 8, 0);
var newBuf = buffer.slice(0, 4);
var head_1 = newBuf[0].toString(16);
var head_2 = newBuf[1].toString(16);
var head_3 = newBuf[2].toString(16);
var head_4 = newBuf[3].toString(16);
var head_iden = head_1 + head_2;

var tempFileType = FILE_TYPE_CONFIG[head_iden];
if (!tempFileType) {
  head_iden += head_3;
  tempFileType = FILE_TYPE_CONFIG[head_iden];

  if (!tempFileType) {
    var msg = "Unknow fileType " + new_file_path + '-' + fileType;
    showLog(msg);
    continue;
  }
}

if (tempFileType != fileType) {
  var msg = "Error fileType" + new_file_path + '-' + fileType + '|' + tempFileType + '--正確的圖像文件格式';
  showLog(msg);
  g_errorFileTypArr.push(msg);
}

這裡有個 bug 需要注意:toString(16) 遇到小於 0x10 的位元組時不會補零,會讓拼接出的簽名比對失敗。例如 PNG 檔頭的 0x0D、0x0A 都會被轉成單字元字串。改成 newBuf[0].toString(16).padStart(2, '0') 或直接比對數值陣列會可靠得多。

第二種做法:使用現成套件 node-imageinfo

後來在搜尋 Node 的 image 相關資訊時,找到一篇套件排行榜的文章,篩選出 node-imageinfo 這個模組。寫了個小測試(刻意把 jpg 直接改名成 png)驗證:

它能正確辨識出真實格式,效果符合預期。

它的原始碼

有興趣的話可以研究一下它的實作,核心就是用簽名陣列比對檔頭:

function readUInt32(buffer, offset, bigEndian) {
  if (buffer.readUInt32) {
    return buffer.readUInt32(offset, bigEndian);
  }

  var value;
  if (bigEndian) {
    if (buffer.readUInt32BE) {
      return buffer.readUInt32BE(offset);
    }
    value = (buffer[offset] << 24) + (buffer[offset+1] << 16) + (buffer[offset+2] << 8) + buffer[offset+3];
  } else {
    if (buffer.readUInt32LE) {
      return buffer.readUInt32LE(offset);
    }
    value = buffer[offset] + (buffer[offset+1] << 8) + (buffer[offset+2] << 16) + (buffer[offset+3] << 24);
  }
  return value;
}

function readUInt16(buffer, offset, bigEndian) {
  if (buffer.readUInt16) {
    return buffer.readUInt16(offset, bigEndian);
  }

  var value;
  if (bigEndian) {
    if (buffer.readUInt16BE) {
      return buffer.readUInt16BE(offset);
    }
    value = (buffer[offset] << 8) + buffer[offset+1];
  } else {
    if (buffer.readUInt16LE) {
      return buffer.readUInt16LE(offset);
    }
    value = buffer[offset] + (buffer[offset+1] << 8);
  }
  return value;
}

function readBit(buffer, offset, bitOffset) {
  if (bitOffset > 7) {
    offset += Math.floor(bitOffset / 8);
    bitOffset = bitOffset % 8;
  }

  var b = buffer[offset];
  if (bitOffset < 7) {
    b >>>= (7 - bitOffset);
  }

  var val = b & 0x01;
  return val;
}

function readBits(buffer, offset, bitOffset, bitLen, signed) {
  var val = 0;

  var neg = false;
  if (signed) {
    if (readBit(buffer, offset, bitOffset) > 0) {
      neg = true;
    }
    bitLen--;
    bitOffset++;
  }

  var bytes = [];
  for (var i = 0; i < bitLen; i++) {
    var b = readBit(buffer, offset, bitOffset + i);
    if (i > 0 && (bitLen - i) % 8 == 0) {
      bytes.push(val);
      val = 0;
    }
    val <<= 1;
    val |= b;
  }
  bytes.push(val);

  val = new Buffer(bytes);
  val.negative = neg ? true : false;
  return val;
}

function imageInfoPng(buffer) {
  var imageHeader = [0x49, 0x48, 0x44, 0x52],
    pos = 12;

  if (!checkSig(buffer, pos, imageHeader)) {
    return false;
  }

  pos += 4;
  return {
    type: 'image',
    format: 'PNG',
    mimeType: 'image/png',
    width: readUInt32(buffer, pos, true),
    height: readUInt32(buffer, pos + 4, true),
  };
}

function imageInfoJpg(buffer) {
  var pos = 2,
    len = buffer.length,
    sizeSig = [0xff, [0xc0, 0xc2]];

  while (pos < len) {
    if (checkSig(buffer, pos, sizeSig)) {
      pos += 5;
      return {
        type: 'image',
        format: 'JPG',
        mimeType: 'image/jpeg',
        width: readUInt16(buffer, pos + 2, true),
        height: readUInt16(buffer, pos, true),
      };
    }

    pos += 2;
    var size = readUInt16(buffer, pos, true);
    pos += size;
  }
}

function imageInfoGif(buffer) {
  var pos = 6;

  return {
    type: 'image',
    format: 'GIF',
    mimeType: 'image/gif',
    width: readUInt16(buffer, pos, false),
    height: readUInt16(buffer, pos + 2, false),
  };
}

function imageInfoSwf(buffer) {
  var pos = 8,
    bitPos = 0,
    val;

  if (buffer[0] === 0x43) {
    try {
      // If you have zlib available ( npm install zlib ) then we can read compressed flash files
      buffer = require('zlib').inflate(buffer.slice(8, 100));
      pos = 0;
    } catch (ex) {
      // Can't get width/height of compressed flash files... yet (need zlib)
      return {
        type: 'flash',
        format: 'SWF',
        mimeType: 'application/x-shockwave-flash',
        width: null,
        height: null,
      }
    }
  }

  var numBits = readBits(buffer, pos, bitPos, 5)[0];
  bitPos += 5;

  val = readBits(buffer, pos, bitPos, numBits, true);
  var xMin = (numBits > 9 ? readUInt16(val, 0, true) : val[0]) * (val.negative ? -1 : 1);
  bitPos += numBits;

  val = readBits(buffer, pos, bitPos, numBits, true);
  var xMax = (numBits > 9 ? readUInt16(val, 0, true) : val[0]) * (val.negative ? -1 : 1);
  bitPos += numBits;

  val = readBits(buffer, pos, bitPos, numBits, true);
  var yMin = (numBits > 9 ? readUInt16(val, 0, true) : val[0]) * (val.negative ? -1 : 1);
  bitPos += numBits;

  val = readBits(buffer, pos, bitPos, numBits, true);
  var yMax = (numBits > 9 ? readUInt16(val, 0, true) : val[0]) * (val.negative ? -1 : 1);

  return {
    type: 'flash',
    format: 'SWF',
    mimeType: 'application/x-shockwave-flash',
    width: Math.ceil((xMax - xMin) / 20),
    height: Math.ceil((yMax - yMin) / 20),
  };
}

function checkSig(buffer, offset, sig) {
  var len = sig.length;
  for (var i = 0; i < len; i++) {
    var b = buffer[i + offset],
      s = sig[i],
      m = false;

    if ('number' == typeof s) {
      m = s === b;
    } else {
      for (var k in s) {
        var o = s[k];
        if (o === b) {
          m = true;
        }
      }
    }

    if (!m) {
      return false;
    }
  }

  return true;
}

module.exports = function imageInfo(buffer, path) {
  var pngSig = [0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a];
  var jpgSig = [0xff, 0xd8, 0xff];
  var gifSig = [0x47, 0x49, 0x46, 0x38, [0x37, 0x39], 0x61];
  var swfSig = [[0x46, 0x43], 0x57, 0x53];

  if (checkSig(buffer, 0, pngSig)) return imageInfoPng(buffer);
  if (checkSig(buffer, 0, jpgSig)) return imageInfoJpg(buffer);
  if (checkSig(buffer, 0, gifSig)) return imageInfoGif(buffer);
  if (checkSig(buffer, 0, swfSig)) return imageInfoSwf(buffer);

  return false;
};

設計上的巧思

這段程式碼有兩個值得學的地方。

第一,checkSig 允許簽名陣列的元素本身是陣列,例如 gifSig 中的 [0x37, 0x39] 代表「這個位置可以是 0x37 或 0x39」。這正好對應 GIF87a 與 GIF89a 兩個版本,一個欄位就解決了版本差異的問題。

第二,readUInt32、readUInt16 開頭那幾行都在檢查 buffer.readUInt32 是否存在——這是為了相容很早期的 Node 版本,那時 Buffer 還沒有這些方法。現在 these fallback 分支已經沒有必要,可以直接簡化。

另外提醒,範例中的 new Buffer(8) 從 Node 10 起已被標記為不建議使用(deprecated),請改用 Buffer.alloc(8) 或 Buffer.from()。前者會初始化為零,後者用於從既有資料建立,安全性較高。

結論

判斷圖片真實格式,靠副檔名是不可靠的,必須讀取檔案簽名(magic number)。自己實作難度不高,但既然有成熟套件可用,正式專案直接引入會更省時,也更不容易漏掉邊界情況。

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