百度個人雲盤空間大、完全免費,而且提供了 PCS API 供開發者調用操作文件,在專案裡拿來保存一些文件非常實用。本文就來記錄一下如何用 PCS API 把文件上傳到百度網盤。
環境準備:
首先需要開通網盤的讀寫權限並取得 access_token;接著參考百度官方 PCS API 文檔,裡面提供了各種語言的 SDK。我用的是 Laravel 5,直接引入官方 PHP SDK 無法運行,稍作修改後才能正常使用。完成上述準備後基本就可以動手了。
下面直接貼出「把用戶在網頁上選擇的圖片預覽後上傳到網盤」的代碼。上傳接口的形式為 https://pcs.baidu.com/rest/2.0/pcs/file?method=upload&path=...&access_token=...。其中 path 部分是固定的,因為只允許上傳到 /apps/wp2pcs/ 這個目錄下,對應到網盤就是「我的網盤/我的應用數據/wp2pcs」。無需事先創建目錄,只要指定路徑它會自動創建,例如想上傳到 /apps/wp2pcs/img 下,把 path 寫成 /apps/wp2pcs/img/1.jpg 即可。
預覽部分代碼:
//圖片上傳預覽 IE是用了濾鏡。 function previewImage(file, product) { getPhotopty(); console.log("previewImage"); uploadAndSubmit(product); var div = document.getElementById('preview' + product); var fileName = file.value; //upload(); if (file.files) { var i = 0; var funAppendImage = function () { var _file = file.files[i]; if (_file) { var reader = new FileReader() reader.onload = function (evt) { fileName = _file.name; div.innerHTML += '<div class="col-xs-6 col-md-3"><a style="float:right;cursor:pointer;" onclick="del(this)">X</a><div class="thumbnail"><img id=imghead' + product + fileName + '></div></div>'; var img = document.getElementById('imghead' + product + fileName); img.src = evt.target.result; i++; funAppendImage(); } reader.readAsDataURL(_file); } }; funAppendImage(); } $('#coverBg').show(); $('#coverDiv').show(); //$("#uploadFrm" + product).submit(); }
上傳:
var access_token = "***********"; var baseUrl = "https://c.pcs.baidu.com/rest/2.0/pcs/"; function uploadAndSubmit(product) { console.log("start uploadAndSubmit"); if (typeof FileReader == 'undefined') { alert("你的浏覽器不支持FileReader接口!"); } var taskName = $("#txtTask").val() + "-" + $("#txtTask2").val(); var form = document.forms["uploadFrm" + product]; console.log("form:" + form); var fileCtrl = "filectrl" + product; console.log("filectrl:" + fileCtrl); //if (form[fileCtrl].files.length > 0) console.log($("#filectrl" + product)[0]); if ($("#filectrl" + product)[0].files.length > 0) { for (var i = 0; i < $("#filectrl" + product)[0].files.length; i++) { var file = form[fileCtrl].files[i]; console.log(file.name); var filePath = "%2fapps%2fwp2pcs%2f" + taskName + "%2f" + file.name; console.log("add exif info to db"); getExifIinfo(taskName, file, product, filePath); //document.getElementById("bytesRead").textContent = file.size; console.log("start XMLHttpRequest"); var xhr = new XMLHttpRequest(); console.log(access_token); var url = baseUrl + "file?method=upload&path=%2fapps%2fwp2pcs%2f" + taskName + "%2f" + file.name + "&access_token=" + access_token + "&ondup=overwrite&count=" + i; console.log(url); xhr.open("POST", url, true); var formData = new FormData(); formData.append("file", file); console.log("onreadystatechange"); xhr.onreadystatechange = function () { console.log("onreadystatechange start"); //console.log(xhr.status); if (xhr.readyState == 4) { if (xhr.status == 200) { console.log("upload complete"); console.log("response: " + xhr.responseText); var result = $.parseJSON(xhr.responseText); if (result.hasOwnProperty("path")) { $("#reusltMsg").append('<div class="alert alert-success" role="alert"> 上傳成功.</div>'); } else { $("#reusltMsg").append('<div class="alert alert-danger" role="alert"> 上傳失敗.</div>'); } } else { $("#reusltMsg").append('<div class="alert alert-danger" role="alert"> 上傳失敗(200).</div>'); } } $('#coverBg').hide(); $('#coverDiv').hide(); } xhr.send(formData); } } else { alert("Please choose a file."); $('#coverBg').hide(); $('#coverDiv').hide(); } }
這份實作的關鍵在於使用了瀏覽器的 File API 與 XMLHttpRequest 的組合。預覽環節透過 FileReader 的 readAsDataURL 把用戶選擇的本地圖片讀成 base64,即時顯示縮圖;上傳環節則用 FormData 封裝文件,以 POST 方式送到 PCS 的上傳接口,並透過 onreadystatechange 判斷返回結果——若回應中包含 path 屬性即代表上傳成功。
幾個實務上的提醒:一是 access_token 屬於敏感憑證,實際專案中切勿寫死在前端,應由後端保管並代理請求,以免洩露;二是 path 中的目錄必須固定在授權的 /apps/wp2pcs/ 之下,這是 PCS 的安全限制;三是 ondup=overwrite 表示同名文件直接覆蓋,可依需求調整。整體來說,這示範了如何用純前端方式对接雲存儲服務,思路清晰、值得借鑑。