php文件上傳進(jìn)度處理
當(dāng)文件過大,或者用戶網(wǎng)絡(luò)狀態(tài)一般,通常上傳過程需要一段時間,如果這時候讓用戶白屏等待的話,相信大部分用戶都會直接關(guān)掉應(yīng)用,所以一個監(jiān)控上傳進(jìn)度,并實時向用戶報告的需求就被產(chǎn)品汪擺在了桌面上。一個高逼格的上傳進(jìn)度提示,會讓你的應(yīng)用瞬間變成被仰望的存在。
PHP在5.4之前,總是需要安裝額外的擴展才能監(jiān)控到文件上傳進(jìn)度。而從5.4開始,引入session.upload_progress的新特性,我們只需要在php.ini中開啟配置,即可通過session監(jiān)控文件上傳進(jìn)度。在php.ini中。
注意:本章學(xué)習(xí)需要有session基礎(chǔ)和javascript和ajax基礎(chǔ)。
我們需要配置,注意查看和修改php.ini文件:
配置項 | 說明 |
---|---|
session.upload_progress.enabled | 是否啟用上傳進(jìn)度報告(默認(rèn)開啟) 1為開啟,0為關(guān)閉 |
session.upload_progress.cleanup | 是否在上傳完成后及時刪除進(jìn)度數(shù)據(jù)(默認(rèn)開啟, 推薦開啟) |
session.upload_progress.prefix[=upload_progress_] | 進(jìn)度數(shù)據(jù)將存儲在_SESSION[session.upload_progress.prefix . _POST[session.upload_progress.name]] |
session.upload_progress.name[=PHP_SESSION_UPLOAD_PROGRESS] | 如果_POST[session.upload_progress.name]沒有被設(shè)置, 則不會報告進(jìn)度. |
session.upload_progress.freq[=1%] | 更新進(jìn)度的頻率(已經(jīng)處理的字節(jié)數(shù)), 也支持百分比表示’%’. |
session.upload_progress.min_freq[=1.0] | 更新進(jìn)度的時間間隔(秒級) |
開啟了配置,我們可以通過session,來記錄一個完整的文件上傳進(jìn)度。在session中,會出現(xiàn)一個如下結(jié)果的數(shù)組:
$_SESSION["upload_progress_test"] = array( //請求時間 "start_time" => 1234567890, // 上傳文件總大小 "content_length" => 57343257, //已經(jīng)處理的大小 "bytes_processed" => 453489, //當(dāng)所有上傳處理完成后為TRUE,未完成為false "done" => false, "files" => array( 0 => array( //表單中上傳框的名字 "field_name" => "file1", //上傳文件的名稱 "name" => "test1.avi", //緩存文件,上傳的文件即保存在這里 "tmp_name" => "/tmp/phpxxxxxx", //文件上傳的錯誤信息 "error" => 0, //是否上傳完成,當(dāng)這個文件處理完成后會變成TRUE "done" => true, //這個文件開始處理時間 "start_time" => 1234567890, //這個文件已經(jīng)處理的大小 "bytes_processed" => 57343250, ), 1 => array( "field_name" => "file2", "name" => "test2.avi", "tmp_name" => NULL, "error" => 0, "done" => false, "start_time" => 1234567899, "bytes_processed" => 54554, ), ) );
這個數(shù)組詳細(xì)記錄了文件上傳的進(jìn)度,已經(jīng)處理完的文件狀態(tài)為true。下面,我們通過一個jQuery的AJAX實例,來學(xué)習(xí)一下文件上傳進(jìn)度的流程。
首先,在表單中,需要添加一個type=hidden 的 input 標(biāo)簽,標(biāo)簽 value 為自定義(建議使用有一定意義的值,因為這個值將要在后臺用到)
<form id="upload-form" action="upload.php" method="POST" enctype="multipart/form-data" style="margin:15px 0" target="hidden_iframe"> <input type="hidden" name="<?php echo ini_get("session.upload_progress.name"); ?>" value="test" /> <p><input type="file" name="file1" /></p> <p><input type="submit" value="Upload" /></p> </form> <div id="progress" class="progress" style="margin-bottom:15px;display:none;"> <div class="label">0%</div> </div>
這里,添加了一個ID為progress的div,作為展示上傳進(jìn)度的容器。我們通過js的setTimeout(),定時執(zhí)行ajax來獲取文件上傳進(jìn)度,后臺文件返回文件上傳的進(jìn)度百分比。
<script src="../jquery/1.8.2/jquery.min.js"></script> <script type="text/javascript"> function fetch_progress(){ $.get('progress.php',{ '<?php echo ini_get("session.upload_progress.name"); ?>' : 'test'}, function(data){ var progress = parseInt(data); $('#progress .label').html(progress + '%'); if(progress < 100){ setTimeout('fetch_progress()', 100); //當(dāng)上傳進(jìn)度小于100%時,顯示上傳百分比 }else{ $('#progress .label').html('完成!'); //當(dāng)上傳進(jìn)度等于100%時,顯示上傳完成 } }, 'html'); } $('#upload-form').submit(function(){ $('#progress').show(); setTimeout('fetch_progress()', 100);//每0.1秒執(zhí)行一次fetch_progress(),查詢文件上傳進(jìn)度 }); </script>
上面這段代碼,就是通過JQ的ajax,每0.1秒返回一次文件上傳進(jìn)度。并把進(jìn)度百分比在div 標(biāo)簽中顯示。
后臺代碼,需要分為兩個部分,upload.php處理上傳文件。progress.php 獲取session中的上傳進(jìn)度,并返回進(jìn)度百分比。
這里文件上傳就不再贅述,詳細(xì)步驟參見上文,upload.php:
<?php if(is_uploaded_file($_FILES['file1']['tmp_name'])){ //判斷是否是上傳文件 //unlink($_FILES['file1']['tmp_name']); move_uploaded_file($_FILES['file1']['tmp_name'], "./{$_FILES['file1']['name']}"); //將緩存文件移動到指定位置 } ?>
主要關(guān)注progress.php:
<?php /* 開啟session。請注意在session_start()之前,請不要有想瀏覽器輸出內(nèi)容的動作,否則可能引起錯誤。 */ session_start(); //ini_get()獲取php.ini中環(huán)境變量的值 $i = ini_get('session.upload_progress.name'); //ajax中我們使用的是get方法,變量名稱為ini文件中定義的前綴 拼接 傳過來的參數(shù) $key = ini_get("session.upload_progress.prefix") . $_GET[$i]; //判斷 SESSION 中是否有上傳文件的信息 if (!empty($_SESSION[$key])) { //已上傳大小 $current = $_SESSION[$key]["bytes_processed"]; //文件總大小 $total = $_SESSION[$key]["content_length"]; //向 ajax 返回當(dāng)前的上傳進(jìn)度百分比。 echo $current < $total ? ceil($current / $total * 100) : 100; }else{ echo 100; } ?>
到這里,文件進(jìn)度的代碼就已經(jīng)完成了,配合前端,我們就可以做一個炫酷的文件上傳功能啦!