文件上傳進(jìn)度反饋, 這個(gè)需求在當(dāng)前是越來(lái)越普遍, 比如大附件郵件. 在PHP5.4以前, 我們可以通過(guò)APC提供的功能來(lái)實(shí)現(xiàn). 或者使用PECL擴(kuò)展uploadprogress來(lái)實(shí)現(xiàn).
雖然說(shuō), 它們能很好的解決現(xiàn)在的問(wèn)題, 但是也有很明顯的不足:
- 1. 他們都需要額外安裝(我們并沒(méi)有打算把APC加入PHP5.4)
- 2. 它們都使用本地機(jī)制來(lái)存儲(chǔ)這些信息, APC使用共享內(nèi)存, 而
uploadprogress使用文件系統(tǒng)(不考慮NFS), 這在多臺(tái)前端機(jī)的時(shí)候會(huì)造成麻煩.
從PHP的角度來(lái)說(shuō), 最好的儲(chǔ)存這些信息的地方應(yīng)該是SESSION, 首先它是PHP原生支持的機(jī)制. 其次, 它可以被配置到存放到任何地方(支持多機(jī)共享).
正因?yàn)榇? Arnaud Le Blanc提出了針對(duì)Session報(bào)告上傳進(jìn)度的RFC, 并且現(xiàn)在實(shí)現(xiàn)也已經(jīng)包含在了PHP5.4的主干中.
這個(gè)新特性, 提供了一些新的INI配置, 他們和APC的相關(guān)配置很類似:
* session.upload_progress.enabled[=1] : 是否啟用上傳進(jìn)度報(bào)告(默認(rèn)開(kāi)啟)
* session.upload_progress.cleanup[=1] : 是否在上傳完成后及時(shí)刪除進(jìn)度數(shù)據(jù)(默認(rèn)開(kāi)啟, 推薦開(kāi)啟).
* session.upload_progress.prefix[=upload_progress_] : 進(jìn)度數(shù)據(jù)將存儲(chǔ)在_SESSION[session.upload_progress.prefix . _POST[session.upload_progress.name]]
* session.upload_progress.name[=PHP_SESSION_UPLOAD_PROGRESS] : 如果_POST[session.upload_progress.name]沒(méi)有被設(shè)置, 則不會(huì)報(bào)告進(jìn)度.
* session.upload_progress.freq[=1%] : 更新進(jìn)度的頻率(已經(jīng)處理的字節(jié)數(shù)), 也支持百分比表示’%’.
* session.upload_progress.min_freq[=1.0] : 更新進(jìn)度的時(shí)間間隔(秒級(jí))
對(duì)于如下的上傳表單:
<form action="upload.php" method="POST" enctype="multipart/form-data">
<input type="hidden"
name="<?php echo ini_get("session.upload_progress.name"); ?>" value="laruence" />
<input type="file" name="file1" />
<input type="file" name="file2" />
<input type="submit" />
</form>
如果我們上傳一個(gè)足夠大的文件(網(wǎng)速要是足夠慢就更好:P), 我們就可以從_SESSION中, 得到類似下面的進(jìn)度信息:
<?php
$_SESSION["upload_progress_laruence"] = array(
"start_time" => 1234567890, // 請(qǐng)求時(shí)間
"content_length" => 57343257, // 上傳文件總大小
"bytes_processed" => 453489, // 已經(jīng)處理的大小
"done" => false, // 當(dāng)所有上傳處理完成后為T(mén)RUE
"files" => array(
0 => array(
"field_name" => "file1", // 表單中上傳框的名字
// The following 3 elements equals those in $_FILES
"name" => "foo.avi",
"tmp_name" => "/tmp/phpxxxxxx",
"error" => 0,
"done" => true, // 當(dāng)這個(gè)文件處理完成后會(huì)變成TRUE
"start_time" => 1234567890, // 這個(gè)文件開(kāi)始處理時(shí)間
"bytes_processed" => 57343250, // 這個(gè)文件已經(jīng)處理的大小
),
// An other file, not finished uploading, in the same request
1 => array(
"field_name" => "file2",
"name" => "bar.avi",
"tmp_name" => NULL,
"error" => 0,
"done" => false,
"start_time" => 1234567899,
"bytes_processed" => 54554,
),
)
);