注意: 此特性自 PHP 5.4.0 后可用。
當 session.upload_progress.enabled INI 選項開啟時，PHP 能夠在每一個文件上傳時監(jiān)測上傳進度。 這個信息對上傳請求自身并沒有什么幫助，但在文件上傳時應用可以發(fā)送一個POST請求到終端（例如通過XHR）來檢查這個狀態(tài)
當一個上傳在處理中，同時POST一個與INI中設(shè)置的session.upload_progress.name同名變量時，上傳進度可以在$_SESSION中獲得。 當PHP檢測到這種POST請求時，它會在$_SESSION中添加一組數(shù)據(jù), 索引是 session.upload_progress.prefix 與 session.upload_progress.name連接在一起的值。 通常這些鍵值可以通過讀取INI設(shè)置來獲得，例如
<?php
$key = ini_get("session.upload_progress.prefix") . ini_get("session.upload_progress.name");
var_dump($_SESSION[$key]);
?>
通過將$_SESSION[$key]["cancel_upload"]設(shè)置為true，還可以取消一個正在處理中的文件上傳。
當在同一個請求中上傳多個文件，它僅會取消當前正在處理的文件上傳和未處理的文件上傳，但是不會移除那些已經(jīng)完成的上傳。
當一個上傳請求被這么取消時，$_FILES中的error將會被設(shè)置為
UPLOAD_ERR_EXTENSION。
session.upload_progress.freq 和 session.upload_progress.min_freq INI選項控制了上傳進度信息應該多久被重新計算一次。 通過合理設(shè)置這兩個選項的值，這個功能的開銷幾乎可以忽略不計。
示例 #1 樣例信息
一個上傳進度數(shù)組的結(jié)構(gòu)的例子
<form action="upload.php" method="POST" enctype="multipart/form-data">
<input type="hidden" name="<?php echo ini_get("session.upload_progress.name"); ?>" value="123" />
<input type="file" name="file1" />
<input type="file" name="file2" />
<input type="submit" />
</form>
在session中存放的數(shù)據(jù)看上去是這樣子的：
<?php
$_SESSION["upload_progress_123"] = array(
"start_time" => 1234567890, // The request time
"content_length" => 57343257, // POST content length
"bytes_processed" => 453489, // Amount of bytes received and processed
"done" => false, // true when the POST handler has finished, successfully or not
"files" => array(
0 => array(
"field_name" => "file1", // Name of the <input/> field
// The following 3 elements equals those in $_FILES
"name" => "foo.avi",
"tmp_name" => "/tmp/phpxxxxxx",
"error" => 0,
"done" => true, // True when the POST handler has finished handling this file
"start_time" => 1234567890, // When this file has started to be processed
"bytes_processed" => 57343250, // Amount of bytes received and processed for this file
),
// 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,
),
)
);
為了使這個正常工作，web服務(wù)器的請求緩沖區(qū)需要禁用，否則 PHP可能僅當文件完全上傳完成時才能收到文件上傳請求。 已知會緩沖這種大請求的程序有Nginx。
這個進度信息是在任意腳本被執(zhí)行前寫入session的，因此通過 ini_set()或session_name()修改session名將會導致一個沒有上傳進度信息的session。