無論是PHP，還是其他的服務端腳本都提供了文件上傳功能，實現起來也比較簡單。而利用JavaScript來配合，即可實現Ajax方式的文件上傳。雖然jQuery本身沒有提供這樣的簡化函數，但有不少插件可以實現。其中，Phpletter.com提供的ajaxfileupload.js是一個輕量的插件，而且編寫方式與jQuery提供的全局方法$.post()非常相似，簡單易用。
不過，該插件實在太簡化了，除了可提供需上傳文件的路徑外，也就不能傳遞額外的值到后臺服務端。所以，我修改了一下該腳本，增加個一個data對象參數。
一、原理
我這里使用的是PHP作為服務端腳本，幾乎在每本較少PHP的書上都會提到如何使用move_uploaded_file()方法來上傳文件，這里我就不再細說了。我想說的是，利用Ajax上傳的原理。
因為一直在使用jQuery庫，所以當想到Ajax時，第一反應就是試試$.post()方法，利用各選擇器得到file文件框中的value值，然后提交到后臺服務端。當然，后來證明這是不行的。（正因為這問題，我還查了不少資料，網上還提供了不少ASP等方式的腳本，真不知道該說什么好。。）
回到正題，要實現Ajax方式上傳，其實并不難，方法也有不少。而本文提到的Phpletter.com的ajaxfileupload.js插件就是使用iframe的方式。這也是在不使用JavaScript腳本時，要實現不刷新頁面上傳時常見的方法。（本博客bo-blog后臺撰寫日志就是用該方法）
而ajaxfileupload.js插件也很簡單，就是先利用jQuery的選擇器獲得file文件上傳框中的文件路徑值，然后動態的創建一個iframe，并在里面建立一個新的file 文件框，提供post方式提交到后臺。最后，返回結果到前臺。
二、使用
ajaxfileupload.js插件的使用很簡單。
前臺HTML代碼類似：
<script type="text/javascript">$(#buttonUplod).click(function () { $.ajaxFileUpload ({ url:'doajaxfileupload.php', //你處理上傳文件的服務端 secureuri:false, //與頁面處理代碼中file相對應的ID值 fileElementId:'img', dataType: 'json', //返回數據類型:text，xml，json，html,scritp,jsonp五種 success: function (data) { alert(data.file_infor); } })});</script><input id="img" type="file" size="45" name="img" ><button id="buttonUpload" onclick="return ajaxFileUpload();">Upload</button> 后臺doajaxfileupload.php腳本：
<?php $upFilePath = "../attachment/";$ok=@move_uploaded_file($_FILES['img']['tmp_name'],$upFilePath); if($ok === FALSE){ echo json_encode('file_infor'=>'上傳失敗'); }else{ echo json_encode('file_infor'=>'上傳成功'); }?>
為了測試，可以使用類似下面的方式保存傳遞過來的變量值：
$file_info = var_export($_FILES,true);
$ok = file_put_contents("../attachment/file_info.txt",$file_info);
if ($ok) exit(json_encode('file_infor'=>'上傳成功'));
exit (json_encode('file_infor'=>'上傳失敗'));
※ 注意
請留意HTML代碼文件框中的標記：
1. id='img'是用于給ajaxfileupload.js插件的fileElementId:'img'識別的，jQuery選擇器會利用該字符串獲得文本框的值；
2. name='img'是用于通過post方式提交到后臺腳本時，PHP通過$_FILES['img']讀取上傳文件的數據，若沒有該值，$_FILES變量為空；
所以，這兩個值缺一不可，也不可混淆。
三、支持額外參數
有時候，我們需要在后臺根據某些變量來覺得對上傳文件的處理。例如，更新文件。這時，就需要往同臺再傳遞一些額外的參數。所以，我修改了ajaxfileupload.js插件：
addOtherRequestsToForm: function(form,data){ // add extra parameter var originalElement = $('<input type="hidden" name="" value="">'); for (var key in data) { name = key; value = data[key]; var cloneElement = originalElement.clone();cloneElement.attr({'name':name,'value':value}); $(cloneElement).appendTo(form); } return form;}, ajaxFileUpload: function(s) { // TODO introduce global settings, allowing the client to modify them for all requests, not only timeout s = jQuery.extend({}, jQuery.ajaxSettings, s); var id = new Date().getTime() var form = jQuery.createUploadForm(id, s.fileElementId); if ( s.data ) form = jQuery.addOtherRequestsToForm(form,s.data); var io = jQuery.createUploadIframe(id, s.secureuri); 紅色標記部分是我添加的內容。這樣，我就可以在前臺HTML部分，通過類似下面的代碼來傳遞額外的參數：
url:'doajaxfileupload.php', //你處理上傳文件的服務端
secureuri:false, //與頁面處理代碼中file相對應的ID值
data:{'test':'test','ok':'ok'}, //以對象的方式傳遞，內容部分可輸入JavaScript的變量值
fileElementId:'img',
后臺處理腳本為：
array_push($_FILES,$_REQUEST);$file_info = var_export($_FILES,true);$ok = file_put_contents("../attachment/file_info.txt",$file_info);if ($ok) exit(json_encode('file_infor'=>'上傳成功'));exit (json_encode('file_infor'=>'上傳失敗')); 可見，原理很簡單，就是把額外的data對象內容一同加到iframe下的form中，傳遞到后臺PHP腳本，以$_REQUEST等變量獲得這些值。
后臺輸出保留的file_info.txt內容如下：
array (
'file' =>
array (
'name' => 'firefox-java.txt',
'type' => 'text/plain',
'tmp_name' => 'D://Tools//xampp//tmp//phpED45.tmp',
'error' => 0,
'size' => 250,
),
0 =>
array (
'test' => 'test',
'ok' => 'ok',
'PHPSESSID' => 'e379fd4fb2abca6e802a1302805a5535',
),
)
ajaxfileupload.js:
jQuery.extend({ createUploadIframe: function(id, uri) { //create framevar frameId = 'jUploadFrame' + id;if(window.ActiveXObject) {var io = document.createElement('<iframe id="' + frameId + '" name="' + frameId + '" />');if(typeof uri== 'boolean'){io.src = 'javascript:false';}else if(typeof uri== 'string'){io.src = uri;}}else {var io = document.createElement('iframe');io.id = frameId;io.name = frameId;}io.style.position = 'absolute';io.style.top = '-1000px';io.style.left = '-1000px'; document.body.appendChild(io); return io }, createUploadForm: function(id, fileElementId) { //create form var formId = 'jUploadForm' + id; var fileId = 'jUploadFile' + id; var form = $('<form action="" method="POST" name="' + formId + '" id="' + formId + '" enctype="multipart/form-data"></form>'); var oldElement = $('#' + fileElementId); var newElement = $(oldElement).clone(); $(oldElement).attr('id', fileId); $(oldElement).before(newElement); $(oldElement).appendTo(form); //set attributes $(form).css('position', 'absolute'); $(form).css('top', '-1200px'); $(form).css('left', '-1200px'); $(form).appendTo('body'); return form; }, addOtherRequestsToForm: function(form,data) { // add extra parameter var originalElement = $('<input type="hidden" name="" value="">'); for (var key in data) { name = key; value = data[key]; var cloneElement = originalElement.clone(); cloneElement.attr({'name':name,'value':value}); $(cloneElement).appendTo(form); } return form; }, ajaxFileUpload: function(s) { // TODO introduce global settings, allowing the client to modify them for all requests, not only timeout s = jQuery.extend({}, jQuery.ajaxSettings, s); var id = new Date().getTime() var form = jQuery.createUploadForm(id, s.fileElementId); if ( s.data ) form = jQuery.addOtherRequestsToForm(form,s.data); var io = jQuery.createUploadIframe(id, s.secureuri); var frameId = 'jUploadFrame' + id; var formId = 'jUploadForm' + id; // Watch for a new set of requests if ( s.global && ! jQuery.active++ ) { jQuery.event.trigger( "ajaxStart" ); } var requestDone = false; // Create the request object var xml = {} if ( s.global )jQuery.event.trigger("ajaxSend", [xml, s]); // Wait for a response to come back var uploadCallback = function(isTimeout) { var io = document.getElementById(frameId);try { if(io.contentWindow) { xml.responseText = io.contentWindow.document.body?io.contentWindow.document.body.innerHTML:null; xml.responseXML = io.contentWindow.document.XMLDocument?io.contentWindow.document.XMLDocument:io.contentWindow.document; }else if(io.contentDocument) { xml.responseText = io.contentDocument.document.body?io.contentDocument.document.body.innerHTML:null; xml.responseXML = io.contentDocument.document.XMLDocument?io.contentDocument.document.XMLDocument:io.contentDocument.document; } }catch(e) { jQuery.handleError(s, xml, null, e); }if ( xml || isTimeout == "timeout") { requestDone = true;var status;try {status = isTimeout != "timeout" ? "success" : "error";// Make sure that the request was successful or notmodifiedif ( status != "error" ) {// process the data (runs the xml through httpData regardless of callback)var data = jQuery.uploadHttpData( xml, s.dataType ); // If a local callback was specified, fire it and pass it the dataif ( s.success )s.success( data, status );// Fire the global callbackif( s.global )jQuery.event.trigger( "ajaxSuccess", [xml, s] );} elsejQuery.handleError(s, xml, status);} catch(e) {status = "error";jQuery.handleError(s, xml, status, e);} // The request was completedif( s.global )jQuery.event.trigger( "ajaxComplete", [xml, s] ); // Handle the global AJAX counterif ( s.global && ! --jQuery.active )jQuery.event.trigger( "ajaxStop" ); // Process resultif ( s.complete )s.complete(xml, status); jQuery(io).unbind() setTimeout(function() { try { $(io).remove(); $(form).remove(); } catch(e) { jQuery.handleError(s, xml, null, e); } }, 100) xml = null } } // Timeout checker if ( s.timeout > 0 ) {setTimeout(function(){// Check to see if the request is still happeningif( !requestDone ) uploadCallback( "timeout" );}, s.timeout); } try { // var io = $('#' + frameId); var form = $('#' + formId); $(form).attr('action', s.url); $(form).attr('method', 'POST'); $(form).attr('target', frameId);if(form.encoding) {form.encoding = 'multipart/form-data'; }else { form.enctype = 'multipart/form-data';} $(form).submit(); } catch(e) { jQuery.handleError(s, xml, null, e); }if(window.attachEvent){document.getElementById(frameId).attachEvent('onload', uploadCallback); } else{document.getElementById(frameId).addEventListener('load', uploadCallback, false); } return {abort: function () {}}; }, uploadHttpData: function( r, type ) { var data = !type; data = type == "xml" || data ? r.responseXML : r.responseText; // If the type is "script", eval it in global context if ( type == "script" )jQuery.globalEval( data ); // Get the JavaScript object, if JSON is used. if ( type == "json" )eval( "data = " + data ); // evaluate scripts within html if ( type == "html" )jQuery("<div>").html(data).evalScripts(); //alert($('param', data).each(function(){alert($(this).attr('value'));})); return data; }}) 新聞熱點
疑難解答
