PHP使用Session实现上传进度功能详解
本文实例讲述了PHP使用Session实现上传进度功能。分享给大家供大家参考,具体如下:
实现文件上传进度条基本是依靠JS插件或HTML5的FileAPI来完成,其实PHP配合ajax也能实现此功能。
PHP手册对于session上传进度是这么介绍的:
当session.upload_progress.enabledINI选项开启时,PHP能够在每一个文件上传时监测上传进度。这个信息对上传请求自身并没有什么帮助,但在文件上传时应用可以发送一个POST请求到终端(例如通过XHR)来检查这个状态
当一个上传在处理中,同时POST一个与INI中设置的session.upload_progress.name同名变量时,上传进度可以在$_SESSION中获得。当PHP检测到这种POST请求时,它会在$_SESSION中添加一组数据,索引是session.upload_progress.prefix与session.upload_progress.name连接在一起的值。通常这些键值可以通过读取INI设置来获得,例如
通过将$_SESSION[$key]["cancel_upload"]设置为TRUE,还可以取消一个正在处理中的文件上传。当在同一个请求中上传多个文件,它仅会取消当前正在处理的文件上传和未处理的文件上传,但是不会移除那些已经完成的上传。当一个上传请求被这么取消时,$_FILES中的error将会被设置为UPLOAD_ERR_EXTENSION。
session.upload_progress.freq和session.upload_progress.min_freqINI选项控制了上传进度信息应该多久被重新计算一次。通过合理设置这两个选项的值,这个功能的开销几乎可以忽略不计。
注意:为了使这个正常工作,web服务器的请求缓冲区需要禁用,否则PHP可能仅当文件完全上传完成时才能收到文件上传请求。已知会缓冲这种大请求的程序有Nginx。
下面原理介绍:
当浏览器向服务器端上传一个文件时,PHP将会把此次文件上传的详细信息(如上传时间、上传进度等)存储在session当中。然后,随着上传的进行,周期性的更新session中的信息。这样,浏览器端就可以使用Ajax周期性的请求一个服务器端脚本,由该脚本返回session中的进度信息;浏览器端的Javascript即可根据这些信息显示/更新进度条了。
php.ini需配置以下选项
session.upload_progress.enabled="1" session.upload_progress.cleanup="1" session.upload_progress.prefix="upload_progress_" session.upload_progress.name="PHP_SESSION_UPLOAD_PROGRESS" session.upload_progress.freq="1%" session.upload_progress.min_freq="1"
其中enabled控制upload_progress功能的开启与否,默认开启;
cleanup则设置当文件上传的请求提交完成后,是否清除session的相关信息,默认开启,如果需要调试$_SESSION,则应该设为Off。
prefix和name两项用来设置进度信息在session中存储的变量名/键名。
freq和min_freq两项用来设置服务器端对进度信息的更新频率。合理的设置这两项可以减轻服务器的负担。
在上传文件的表单中,需要为该次上传设置一个标识符,并在接下来的过程中使用该标识符来引用进度信息。
具体的,在上传表单中需要有一个隐藏的input,它的name属性为php.ini中session.upload_progress.name的值;它的值为一个由你自己定义的标识符。如下:
代码如下:
"value="test"/>
接到文件上传的表单后,PHP会在$_SESSION变量中新建键,键名是一个将session.upload_progress.prefix的值与上面自定义的标识符连接后得到的字符串,可以这样得到:
代码如下:
$name=ini_get('session.upload_progress.name'); $key=ini_get('session.upload_progress.prefix').$_POST[$name]; $_SESSION[$key];//这里就是此次文件上传的进度信息了 $_SESSION[$key]这个变量的结构是这样的: array( 'upload_progress_test'=>array( 'start_time'=>1491494993,//开始时间 'content_length'=>1410397,//POST请求的总数据长度 'bytes_processed'=>1410397,//已收到的数据长度 'done'=>true,//请求是否完成true表示完成,false未完成 'files'=>array( 0=>array( 'field_name'=>'file1', 'name'=>'test.jpg', 'tmp_name'=>'D:\\wamp\\tmp\\phpE181.tmp', 'error'=>0, 'done'=>true, 'start_time'=>1491494993, 'bytes_processed'=>1410096, ), ), ), );
这样,我们就可以使用其中的content_length和bytes_processed两项来得到进度百分比。
原理介绍完了,下面我们来完整的实现一个基于PHP和Javascript的文件上传进度条。
上传表单index.php
PHP(5.4)Session上传进度Demo body{ font-size:1em; color:#333; font-family:"宋体",Arial,sans-serif; } h1,h2,h3,h4,h5,h6{ font-family:"宋体",Georgia,serif; color:#000; line-height:1.8em; margin:0; } h1{font-size:1.8em;} #wrap{ margin-top:15px; margin-bottom:50px; background:#fff; border-radius:5px; box-shadow:inset003px#000, 003px#eee; } #header{ border-radius:5px5px00; box-shadow:inset003px#000; padding:015px; color:#fff; background:#333333; } #headerh1{ color:#fff; } #article{ padding:015px; } #footer{ text-align:center; border-top:1pxsolid#ccc; border-radius:005px5px; } .progress{ width:100%; border:1pxsolid#4da8fe; border-radius:40px; height:20px; position:relative; } .progress.labels{ position:relative; text-align:center; } .progress.bar{ position:absolute; left:0; top:0; background:#4D90FE; height:20px; line-height:20px; border-radius:40px; min-width:20px; } .report-file{ display:block; position:relative; width:120px; height:28px; overflow:hidden; border:1pxsolid#428bca; background:nonerepeatscroll00#428bca; color:#fff; cursor:pointer; text-align:center; float:left; margin-right:5px; } .report-filespan{ cursor:pointer; display:block; line-height:28px; } .file-prew{ cursor:pointer; position:absolute; top:0; left:0; width:120px; height:30px; font-size:100px; opacity:0; filter:alpha(opacity=0); } .container{ padding-left:0; padding-right:0; margin:0auto; } Session上传进度Demo