論壇、貼吧這類場景常常需要一次分享大量圖片。比較差的做法是先把圖片傳到中央伺服器,再由伺服器轉發到靜態圖片伺服器,伺服器白白扛了一趟流量。本文示範如何用 plupload 搭配又拍雲的 HTTP FORM API,讓瀏覽器直接將圖片傳上雲端儲存。重點包含:
plupload 庫簡介
圖片的本地端壓縮
多選圖片
繞過伺服器直接批量上傳到又拍雲
又拍雲 HTTP FORM API 的使用
plupload 的組態設定
plupload 是一個功能相當完整的上傳外掛。它能針對低版本瀏覽器透過 Flash / Silverlight / HTML4 支援批量上傳,在高版本瀏覽器則優先採用 HTML5 介面,而這一切判斷都是自動完成的,使用起來非常省心。此外它也支援在客戶端壓縮圖片、拖拉檔案上傳等能力,細節可參考官方網站。
這裡我們只用到它的核心 API,因此只要引入一個檔案即可:
<script src="lib/plupload-2.1.2/js/plupload.full.min.js"></script>
官方提供的核心 API 範例非常精簡,可直接參考 plupload.com/examples/core,理解上沒有太大門檻。
網頁上顯示的圖片對解析度要求通常不高(還記得學校教的:螢幕用圖 72dpi 就夠,要列印才需要 300dpi)。因此當使用者上傳一張幾 MB 的大照片時,比較合理的做法是在他的瀏覽器裡先壓縮,再把小圖傳出去——視覺上幾乎無損,卻能明顯加快上傳速度、降低伺服器負擔。
plupload 本身支援這個功能,只要在初始化時傳入 resize 參數:
{
"resize": {
"width": 200,
"height": 200,
"quality": 70
}
}
寬高可依需求調整;quality 是關鍵參數,數值越小檔案越小、畫質也越差,需要自行權衡。
批量上傳的前提是能一次選多張圖。多選是 HTML5 的標準特性,寫法很簡單:
<form action="xxx"> Select images: <input type="file" name="img" multiple> <input type="submit"> </form>
multiple 就是關鍵。IE 一直到 IE10 才開始支援這個特性,因此低版本瀏覽器仍需借助 Flash 的力量——好消息是 plupload 已經幫我們做好了,而且預設就是開啟的。若不希望使用多選,可以設定 multi_selection: false 關閉。
又拍雲提供了 FORM API,讓我們能直接從瀏覽器端發起上傳請求,不必經過自家伺服器中轉,大幅降低開銷。
使用這個介面需要向又拍雲送出一個表單,表單中除了要上傳的檔案,還必須包含 policy 與 signature。policy 用來描述這次上傳的相關參數,例如儲存路徑、檔案類型、預處理結果,以及這個上傳請求的授權有效時間;signature 則負責安全校驗。
為了示範方便,下面直接用 JavaScript 產生這兩個值;實際專案中請務必在伺服器端完成簽名運算,避免金鑰外洩。以下程式碼在官方 demo 基礎上稍作修改:
var options = {
'bucket': 'demonstration',
'save-key': '/test/filename.txt',
'expiration': Math.floor(new Date().getTime() / 1000) + 86400
};
var policy = window.btoa(JSON.stringify(options));
// 表單 API 密鑰請從又拍雲後台取得
var form_api_secret = '1+JY2ZqD5UVfw6hQ8EesYQO50Wo=';
var signature = md5(policy + '&' + form_api_secret);
要讓 plupload 配合又拍雲的 FORM API,我原本傷了不少腦筋。翻閱文件時無意看到「Upload to Amazon S3」這段說明——Amazon S3 的雲端儲存服務和又拍雲的形態相當接近,於是照著它的瀏覽器端組態寫法,推出了又拍雲可用的設定。核心其實只有兩個參數:url 與 multipart_params。
var uploader = new plupload.Uploader({
...
url : 'https://v0.api.upyun.com/' + options.bucket,
multipart_params: {
'Filename': '${filename}', // 加上這行以維持各 runtime 的一致性
'Content-Type': '',
'policy': policy,
'signature': signature,
},
...
});
如此一來,就完成了「用 plupload 繞過自家伺服器、直接批量上傳圖片到又拍雲」的目標。整體思路其實不複雜,價值在於把流量壓力從自己的機器移到物件儲存服務上。要提醒的是,plupload 用於商業用途可能需要付費授權,實際規範請以官方網站公告為準。