JS可斷點續傳檔案上傳實現程式碼解析
剛開始學習前端開發就碰到檔案上傳問題,還要求可斷點續傳。查了很多資料,發現H5的file API剛好可以滿足我們的需求,也遇到了一些問題,於是記錄下來為有同樣需求的朋友提供一些幫助。
一、首先,為了引入檔案物件,需要在H5頁面上放置一個file型別的輸入標籤。
<input type="file" onchange="fileInfo()">
當選擇檔案之後顯示檔案相關資訊:
function fileInfo() { let fileObj = document.getElementById('file').files[0]; console.log(fileObj); }
我們獲取到的物件本身是一個數組,這裡只選擇了一個檔案,需要選擇多個檔案可在input標籤新增multiple屬性。現在我們開啟瀏覽器控制檯可以看到輸出了檔案的最後修改時間、檔案大小和檔名等資訊:
二、好了,當我們獲取到選擇的檔案物件之後,現在需要把檔案上傳到伺服器,可以模擬表單事件進行上傳,需要引入FormData物件,其次,由於HTTP對檔案上傳大小的限制,所以要對檔案切塊上傳,在伺服器收到檔案塊之後拼接成一個整體,最後還需要一個進度條去顯示上傳進度。在理清了思路以後這就動手實現:
先在H5頁面放置一個進度條,同時將選擇檔案改變的事件更換為上傳檔案塊的函式upload(開始上傳位元組處),這裡我們從第0個位元組開始上傳,也就是從頭開始傳:
<input type="file" id="file" onchange="upload(0)">
<progress id="progress" max="100" value="0"></progress>
然後來實現檔案塊的上傳函式:
// 檔案切塊大小為1MB const chunkSize = 1024 * 1024; // 從start位元組處開始上傳 function upload(start) { let fileObj = document.getElementById('file').files[0]; // 上傳完成 if (start >= fileObj.size) { return; } // 獲取檔案塊的終止位元組 let end = (start + chunkSize > fileObj.size) ? fileObj.size : (start + chunkSize); // 將檔案切塊上傳 let fd = new FormData(); fd.append('file',fileObj.slice(start,end)); // POST表單資料 let xhr = new XMLHttpRequest(); xhr.open('post','upload.php',true); xhr.onload = function() { if (this.readyState == 4 && this.status == 200) { // 上傳一塊完成後修改進度條資訊,然後上傳下一塊 let progress = document.getElementById('progress'); progress.max = fileObj.size; progress.value = end; upload(end); } } xhr.send(fd); }
這裡使用原生的JS向伺服器傳送請求,將檔案切塊使用函式slice(開始位置,結束位置),然後將檔案塊封裝到FormData物件實現模擬表單的檔案上傳。後臺我使用PHP接收資料,也可以使用其他後端語言:
<?php // 追加檔案塊 $fileName = $_FILES['file']['name']; file_put_contents('files/' . $fileName,file_get_contents($_FILES['file']['tmp_name']),FILE_APPEND); ?>
在這裡我新建了一個資料夾files,將上傳的檔案存放到這裡。獲取的檔案塊內容採用追加的形式FILE_APPEND。於是我們開啟瀏覽器上傳檔案:
然後檢視一下files資料夾下面是否接收到vscode.exe檔案:
三、有了檔案上傳功能,接下來我們要實現斷點續傳功能。在上一步檔案切塊的基礎上,斷點續傳變得非常簡單,如果突然斷網或者瀏覽器意外關閉,那麼上傳的是不完整的檔案,我們只需要在選擇了檔案以後向伺服器查詢一下伺服器上相同檔名的大小,然後將開始上傳位置(位元組)設定到這個大小即可:
先定義一個初始化函式當選擇檔案後向伺服器查詢已上傳檔案大小:
// 初始化上傳大小 function init() { let fileObj = document.getElementById('file').files[0]; let xhr = new XMLHttpRequest(); xhr.onreadystatechange = function() { if (this.readyState == 4 && this.status == 200) { // 將字串轉化為整數 let start = parseInt(this.responseText); // 設定進度條 let progress = document.getElementById('progress'); progress.max = fileObj.size; progress.value = start; // 開始上傳 upload(start); } } xhr.open('post','fileSize.php',true); // 向伺服器傳送檔名查詢大小 xhr.send(fileObj.name); }
在伺服器端使用fileSize.php查詢已上傳檔案大小:
<?php // 接收檔名 $fileName = file_get_contents('php://input'); $fileSize = 0; $path = 'files/' . $fileName; //查詢已上傳檔案大小 if (file_exists($path)) { $fileSize = filesize($path); } echo $fileSize; ?>
最後將H5頁面上input標籤的onchange事件改為init():
<input type="file" onchange="init()">
同時upload函式也不需要重複設定進度條的最大值,修改為:
// 上傳一塊完成後修改進度條資訊,然後上傳下一塊
document.getElementById('progress').value = end;
upload(end);
然後開啟瀏覽器,在上傳過程中故意關閉瀏覽器下次再選擇同一檔案時即可從斷點位置開始續傳。
四、雖然已經實現了可斷點續傳的檔案上傳功能,但是介面還需要美化一下,這裡引用bootstrap框架,需要jquery,順便用jquery的ajax代替原生JS的ajax,需要注意的是$.ajax的processData和contentType屬性都要設定成false:
// POST表單資料 $.ajax({ url: 'upload.php',type: 'post',data: fd,processData: false,contentType: false,success: function() { upload(end); } });
最後美化完成的效果圖如下:
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支援我們。