基于PHP的AJAX技術實現文件異步上傳
異步的文件上傳是在現代的AJAX實現的Web應用里面經常要遇到,必須解決的問題。但是標準的AJAX類(XmlHttpRequest)無法實現傳輸文件的功能。因此,這里討論的內容就是如何在AJAX的技術的基礎之上構建異步的文件上傳功能。在這個功能當中需要使用到內置的框及(IFRAME)來傳輸文件。這個功能實現的效果是頁面在上傳文件的時候,用戶還可以使用該頁面并且填寫文件描述。
這個例子是我們引用AJAX的經典案例進行分析的。
系統環境
· 較新版本的瀏覽器。例如Opera,Firefox或者 Internet Explorer。
· PHP 4.3.0 或更高版本
· PHP 5 版本
· PHP 中的 'short_open_tag' 選項開啟(否則會發生解析錯誤)。
功能分析
通過內置的IFRAME(框架)進行文件上傳。具備包括三個部分組成。
· 在頁面中間有一個簡單的<form...表單,表單只包含了<input type='file' ... >控件。這個表單的目標鏈接就是一個隱藏得IFRAME(通過 CSS的風格' display: none;'實現)并且表單里面唯一一個控件的OnChange事件用來觸發JavaScript函數。這個函數的作用是檢查用戶提交的擴展名,然后提交表單。
· 在服務器端用PHP編寫了一個處理過程(用FILEFRAME坐注釋了)。這個處理過程用來把從客戶端上傳的文件進行檢查后保存在服務器,并且通過Javascript代碼的形式返回給用戶。返回給用戶的Javascript腳本通過'parent.window.document'更改了用戶現在正在查看的頁面,設置了文件的名稱并啟用了讓用戶提交表單的按鈕。啟用按鈕的操作是通過getElementById函數實現的。
· 在主頁面還有一個表單,它包含了用戶提交的描述和隱藏的文件名。用戶可以在文件上傳的同時填寫文件的描述。當文件上傳結束以后,用戶點擊按鈕,就可以看上傳以后返回給用戶的文件信息了。(通過返回來的文件名和用戶輸入的描述構成文件信息)。
可能你會說這么操作不符合常理:文件在用戶確認之前就已經被提交了。如果用戶沒有提交的話,情況會如何呢。你可以自己在擴展處理被用戶放棄的文件。
這個例子把文件存儲在一個文件系統的目錄下。你需要在腳本開始運行的時候配置下這個目錄,具體的包含這個目錄信息的變量是$upload_dir 和$web_upload_dir。這里有一個對目錄是否可寫的權限檢查。
這里我們用到了以下幾個PHP函數:
· move_uploaded_file - 轉移一經上傳到服務器的文件
· fopen - 打開文件
· fwrite - 把內容寫入文件
· fclose - 關閉文件
· str_replace - 替換字符串
· filesize - 返回文件大小
· filemtime - 返回處理時間
你可以通過手冊查到這些函數如果使用。請注意要把HTM(<, >, &)標記替換為(<, > 和 &).
源代碼
<?php$upload_dir = '/var/www/anyexample/aeu'; // 文件存儲的路徑$web_upload_dir = '/aeu'; // 文件在Web目錄下的路徑$tf = $upload_dir.'/'.md5(rand()).'.test';$f = @fopen($tf, 'w');if ($f == false) die('Fatal error! {$upload_dir} is not writable. Set 'chmod 777 {$upload_dir}'or something like this');fclose($f);unlink($tf);
//處理上傳的文件if (isset($_POST['fileframe'])) { $result = 'ERROR'; $result_msg = 'No FILE field found';
if (isset($_FILES['file'])) // 從瀏覽器接受文件 {if ($_FILES['file']['error'] == UPLOAD_ERR_OK) // 沒有錯誤{ $filename = $_FILES['file']['name']; // 文件名 move_uploaded_file($_FILES['file']['tmp_name'], $upload_dir.'/'.$filename); // 處理的主過程-轉移文件到 $upload_dir $result = 'OK';}elseif ($_FILES['file']['error'] == UPLOAD_ERR_INI_SIZE) $result_msg = 'The uploaded file exceeds the upload_max_filesize directive in php.ini';else $result_msg = 'Unknown error'; }
echo '<html><head><title>-</title></head><body>'; echo '<script language='JavaScript' type='text/javascript'>'.'n'; echo 'var parDoc = window.parent.document;'; ' if ($result == 'OK') {echo 'parDoc.getElementById('upload_status').value = 'file successfully uploaded';';echo 'parDoc.getElementById('filename').value = ''.$filename.'';';echo 'parDoc.getElementById('filenamei').value = ''.$filename.'';';echo 'parDoc.getElementById('upload_button').disabled = false;'; } else {echo 'parDoc.getElementById('upload_status').value = 'ERROR: '.$result_msg.'';'; }
echo 'n'.'</script></body></html>'; exit();}
function safehtml($s){ $s=str_replace('&', '&', $s); $s=str_replace('<', '<', $s); $s=str_replace('>', '>', $s); $s=str_replace(''', ''', $s); $s=str_replace(''', '"', $s); return $s;}
if (isset($_POST['description'])){ $filename = $_POST['filename']; $size = filesize($upload_dir.'/'.$filename); $date = date('r', filemtime($upload_dir.'/'.$filename)); $description = safehtml($_POST['description']);
$html =<<<END <html><head><title>{$filename} [uploaded by IFRAME Async file uploader]</title></head> <body><h1>{$filename}</h1><p>This is a file information page for your uploaded file. Bookmark it, or send to anyone...</p><p>Date: {$date}</p><p>Size: {$size} bytes</p><p>Description: <pre>{$description}</pre></p><p><a href='http://www.cgvv.com.cn/bcjs/{$web_upload_dir}/{$filename}' style='font-size: large;'>download file</a><br><a href='http://www.cgvv.com.cn/bcjs/{$PHP_SELF}' style='font-size: small;'>back to file uploading</a><br><a href='http://www.cgvv.com.cn/bcjs/{$web_upload_dir}/upload-log.html' style='font-size: small;'>upload-log</a></p><br><br>Example by <a >AnyExample</a> </body></html> END; $f = fopen($upload_dir.'/'.$filename.'-desc.html', 'w'); fwrite($f, $html); fclose($f); $msg = 'File {$filename} uploaded, <a href='http://www.cgvv.com.cn/bcjs/{$web_upload_dir}/{$filename}-desc.html'>see file information page</a>';
$f = fopen($upload_dir.'/upload-log.html', 'a'); fwrite($f, '<p>$msg</p>n'); fclose($f);
setcookie('msg', $msg); header('Location: http://'.$_SERVER['HTTP_HOST'].$PHP_SELF); exit(); }
if (isset($_COOKIE['msg']) && $_COOKIE['msg'] != '') { if (get_magic_quotes_gpc()) $msg = stripslashes($_COOKIE['msg']); else$msg = $_COOKIE['msg'];setcookie('msg', ''); } ?><!-- Beginning of main page --><html><head><title>IFRAME Async file uploader example</title></head><body><?php if (isset($msg)) echo '<p style='font-weight: bold;'>'.$msg.'</p>';?> <h1>Upload file:</h1><p>File will begin to upload just after selection. </p><p>You may write file description, while you file is being uploaded.</p>
<form action='<?=$PHP_SELF?>' target='upload_iframe' method='post' enctype='multipart/form-data'> <input type='hidden' name='fileframe' value='true'> <!-- Target of the form is set to hidden iframe --> <!-- From will send its post data to fileframe section of this PHP script (see above) -->
<label for='file'>text file uploader:</label><br> <!-- JavaScript is called by OnChange attribute --> <input type='file' name='file' onChange='jsUpload(this)'></form><script type='text/javascript'>/* This function is called when user selects file in file dialog */function jsUpload(upload_field){ // this is just an example of checking file extensions // if you do not need extension checking, remove // everything down to line // upload_field.form.submit(); var re_text = /.txt|.xml|.zip/i; var filename = upload_field.value;
/* Checking file type */ if (filename.search(re_text) == -1) {alert('File does not have text(txt, xml, zip) extension');upload_field.form.reset();return false; }
upload_field.form.submit(); document.getElementById('upload_status').value = 'uploading file...'; upload_field.disabled = true; return true;}</script><iframe name='upload_iframe' style='width: 400px; height: 100px; display: none;'></iframe><!-- For debugging purposes, it's often useful to remove'display: none' from style='' attribute -->
<br>Upload status:<br><input type='text' name='upload_status' value='not uploaded' size='64' disabled><br><br>
File name:<br><input type='text' name='filenamei' value='none' disabled>
<form action='<?=$PHP_SELF?>' method='POST'> <!-- one field is 'disabled' for displaying-only. Other, hidden one is for sending data --> <input type='hidden' name='filename' id='filename'> <br><br>
<label for='photo'>File description:</label><br> <textarea rows='5' cols='50' name='description'></textarea>
<br><br> <input type='submit' value='save file' disabled></form><br><br><a href='http://www.cgvv.com.cn/bcjs/<?=$web_upload_dir?>/upload-log.html'>upload-log</a><br><br><br>
Example by <a >AnyExample</a></body></html>
以上的講解就是提供一種思路供大家參考。大家也可以根據自己的需求進行相應的優化。