Cuando la opción INI session.upload_progress.enabled está habilitada, PHP podrá rastrear el progreso de subida de ficheros individuales que están siendo subidos. Esta información no es particularmente útil para la petición de subida real en sí misma, pero durante la subida del archivo, una aplicación puede enviar una petición POST a un nodo distinto (mediante XHR por ejemplo) para comprobar el estado.
El progreso de subida estará disponible en la variable superglobal $_SESSION cuando una subida está en progreso, y al usar POST con una variable con el mismo nombre al que está establecido el ajuste INI session.upload_progress.name. Cuando PHP detecta tales peticiones POST, rellenará un array en la variable $_SESSION, donde el índice es un valor concatenado de las opciones INI session.upload_progress.prefix y session.upload_progress.name. La clave se recupera normalmente leyendo estas opciones INI, es decir
<?php
$clave = ini_get("session.upload_progress.prefix") . $_POST[ini_get("session.upload_progress.name")];
var_dump($_SESSION[$clave]);
?>
También es posible cancelar la subida de ficheros que está
en progreso, estableciendo la clave $_SESSION[$clave]["cancel_upload"] a
TRUE.
Cuando se suben múltiples ficheros en la misma petición, esto solamente cancelará la
subida de ficheros que está en progreso, y las subidas de ficheros pendientes, pero no
eliminará de manera satisfactoria las subidas completadas.
Cuando una subida se cancela de esta manera, la clave error del
array $_FILES será establecida a
UPLOAD_ERR_EXTENSION.
Las opciones INI session.upload_progress.freq y session.upload_progress.min_freq controlan con qué frecuencia debería ser recalculada la información del progreso de subida. Con una cantidad razonable de estos dos ajustes, la sobrecarga de esta característica es casi inexistente
Ejemplo #1 Ejemplo de información
Ejemplo de la esctructura del array del progreso de subida.
<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>
La información almacenada en la sesión se parecerá a esta:
<?php
$_SESSION["upload_progress_123"] = array(
"start_time" => 1234567890, // El instante de la petición
"content_length" => 57343257, // longitud del contenido de POST
"bytes_processed" => 453489, // Cantidad de bytes recibidos y procesados
"done" => false, // True cuando el gestor de POST ha finalizado, satisfactoriamente o no
"files" => array(
0 => array(
"field_name" => "file1", // nombre del campo <input/>
// Los siguientes 3 elementos son iguales que aquellos de $_FILES
"name" => "foo.avi",
"tmp_name" => "/tmp/phpxxxxxx",
"error" => 0,
"done" => true, // True cuando el gestor de POST ha terminado de manejar este fichero
"start_time" => 1234567890, // Cuándo se empezo a procesar este fichero
"bytes_processed" => 57343250, // Número de bytes recibidos y procesados de este fichero
),
// Otro fichero, no terminado de subir, en la misma petición
1 => array(
"field_name" => "file2",
"name" => "bar.avi",
"tmp_name" => NULL,
"error" => 0,
"done" => false,
"start_time" => 1234567899,
"bytes_processed" => 54554,
),
)
);
El almacenamiento en búfer de peticiones del servidor ha sido deshabilitado para que esto funcione apropiadamente, si no, PHP podría ver la subida de ficheros una vez realizada esta completamente. Los servidores como Nginx almacenan en búfer peticiones más granes.