DIV CSS 佈局教程網

用 jquery.form.js 做 Ajax 圖片上傳:從踩坑到可用的完整解法
編輯:JQuery特效代碼     

專案裡原本沒有統一的上傳函式,每處各寫各的。想說順手整理一版,於是打算做個 ajax 非同步上傳——這技術其實很老了。打開博客園輕鬆找到一篇參考文章,依葫蘆畫瓢把程式碼全改完,進度看起來相當美好。

然後把程式發布到伺服器,上傳就失效了。當場冒汗。都是偷懶抄來沒細看造成的惡果。

回去重讀那篇參考文章,作者其實早就寫明了:這個做法只能在本地使用,不能發布到伺服器。原因是它利用了某些瀏覽器對本機檔案路徑的寬鬆處理,部署後路徑解析規則一變就失效。

難道非得退回 iframe + http post 這種土辦法?不甘心,於是換 Google 全球搜索,最終找到了 jquery.form.js。

為什麼需要 jquery.form.js

瀏覽器的安全模型不允許 XHR 直接上傳檔案——XMLHttpRequest 從一開始就不支援 multipart/form-data。常見的繞道方式是用隱藏 iframe 配合表單 submit,模擬出非同步的假象。jquery.form.js 就是把這套 iframe 手法(以及較新瀏覽器上的 FormData 支援)封裝成 ajaxSubmit(),讓呼叫端寫起來和一般 ajax 一樣。

實作步驟

第一步,引入 jQuery,再引入 jquery.form.js。

第二步,建立一個 .ashx 一般處理常式接收檔案。

前端程式碼:

<script src="<%=Url.Content("~/Scripts/jquery-1.4.1.js") %>" type="text/javascript"></script>
<script src="<%=Url.Content("~/Scripts/jquery.form.js") %>" type="text/javascript"></script>

<script type="text/javascript">
$(function () {
    $("#btnUpload").click(function () {
        if ($("#flUpload").val() == "") {
            alert("請選擇一個圖片文件,再點擊上傳。");
            return;
        }

        $('#UpLoadForm').ajaxSubmit({
            success: function (html, status) {
                var result = html.replace("<pre>", "").replace("</pre>", "");
                $("#image").attr('src', result);
                alert(result);
            }
        });
    });
});
</script>

後端 ashx:

namespace TestMvc.Utility
{
    public class PicUploadHander : IHttpHandler
    {
        public void ProcessRequest(HttpContext context)
        {
            context.Response.ContentType = "text/plain";

            // TODO: 驗證上傳權限

            try
            {
                string fileNamePath = context.Request.Files[0].FileName;
                string savedFileResult = UpLoadImage(fileNamePath, context);
                context.Response.Write(savedFileResult);
            }
            catch
            {
                context.Response.Write("上傳提交出錯");
            }
        }

        public bool IsReusable { get { return false; } }
    }
}

整個流程是:ajax 非同步送出表單 → ashx 存檔並回傳圖片的相對路徑 → 前端回呼把該路徑塞進 <img> 的 src。相比傳統「送出後整頁刷新」的上傳方式,使用者體驗明顯更好。

回傳字串為什麼要清 <pre>

程式碼裡那兩行 replace("<pre>", "") 不是多餘的。某些伺服器/IIS 設定下,ashx 或一般處理常式的純文字輸出會被包上一層 <pre> 標籤(瀏覽器對 text/plain 回應的呈現方式所致),不清掉就會把標籤當成圖片路徑的一部分,圖片自然顯示不出來。較穩妥的做法是在 ashx 明確設定 context.Response.ContentType = "text/plain",並在前端用 dataType: "text" 指定回應型別,而不是事後用字串取代去補。

正式環境必須補上的四件事

這個範例能跑,但直接上線風險很高。

一、副檔名與內容型別驗證。只檢查「有沒有選檔」等於完全開放。必須建立副檔名白名單(.jpg/.png/.gif),並且檢查檔案的實際內容——單看副檔名可以偽造,應該比對 magic number 或後端重新解碼驗證。

二、檔案大小限制。既要設 maxRequestLength/maxAllowedContentLength(伺服器層),也要在 JS 端先檢查 file.size 給出即時回饋,避免使用者等半分鐘才看到錯誤。

三、檔名不可直接使用。context.Request.Files[0].FileName 完全來自用戶端,可能包含 ../ 路徑跳脫或中文編碼問題。應改用伺服器端產生的 GUID 作為實際檔名,原始檔名另行記錄在資料庫。

四、儲存位置不可在 Web 可執行目錄內。存檔資料夾應禁止執行(IIS 中設定「請求處理常式 → 移除 Script 對應」),否則一旦驗證被繞過,上傳的檔案就可能被當成程式執行。

範例程式下載(Firefox 下測試通過):https://xiazai.jb51.net/201011/yuanma/AjaxUploadPic.rar

順帶一提,如果不需要舊版 IE 相容,現代瀏覽器可直接用 FormData 搭配 $.ajax(記得設 processData: false 與 contentType: false),並能用 XMLHttpRequest.upload.onprogress 取得上傳進度百分比,比 iframe 方案勝出不少。

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