fileinput 是一款基於 Bootstrap 的上傳組件,開箱就有多選、拖拽、縮圖預覽、進度條和文件大小校驗,界面比原生 file 控件友好得多。本文記錄接入步驟。
<link href="__PUBLIC__/CSS/bootstrap.css" rel="stylesheet"> <link type="text/css" rel="stylesheet" href="__PUBLIC__/CSS/fileinput.css" /> <script type="text/javascript" src="__PUBLIC__/JS/bootstrap.min.js"></script> <script type="text/javascript" src="__PUBLIC__/JS/jquery.min.js"></script> <script type="text/javascript" src="__PUBLIC__/JS/fileinput.js"></script> <script type="text/javascript" src="__PUBLIC__/JS/fileinput_locale_zh.js"></script> <!--中文包,不需要可以不用導入-->
順序要注意:jQuery 必須在 bootstrap 與 fileinput 之前加載,中文語言包放在最後。
<form enctype="multipart/form-data"> <input id="file-1" name="file" type="file" multiple class="file" data-overwrite-initial="false" data-min-file-count="1"/> </form>
enctype="multipart/form-data" 是文件上傳的必要條件,multiple 開啟多選。
$("#file-1").fileinput({
uploadUrl: '', // 必須設置個路徑進入php代碼部分
allowedFileExtensions: ['jpg', 'png', 'gif', 'txt', 'zip', 'ico', 'jpeg', 'js', 'css', 'java', 'mp3', 'mp4', 'doc', 'docx'], //允許的文件類型
overwriteInitial: false,
maxFileSize: 1500, //文件的最大大小,單位是k
maxFilesNum: 10, //最多文件數量
// allowedFileTypes: ['image', 'video', 'flash'],
slugCallback: function(filename) {
return filename;
}
});
uploadUrl 是必填項,指向處理上傳的後台地址;maxFileSize 的單位是 KB;slugCallback 用來自定義文件名處理規則,這裡直接原樣返回。
$file = $_FILES['file']; //獲取上傳文件的信息,數組形式 $date['file_name'] = $file['name']; //文件的名稱 $date['file_size'] = $file['size']; //文件的大小 $date['file_type'] = $file['type']; //文件的類型
完成保存後,用 Ajax 返回一段錯誤信息或成功信息即可;直接 echo 也可以,插件會自動解析響應並更新界面。


前端的 allowedFileExtensions 和 maxFileSize 只是用戶體驗優化,繞過極其容易,服務端必須做同樣的校驗:檢查 $_FILES['file']['error']、用白名單判斷擴展名、核對 MIME 類型、限制大小,保存時不要直接使用客戶端傳來的文件名,應重新生成隨機名以防路徑穿越與覆蓋。另外,多文件循環保存時記得判斷返回值,把失敗的文件名彙總回傳給前端。