编程语言
首页 > 编程语言> > PHP实现大文件断点下载

PHP实现大文件断点下载

作者:互联网

什么是断点续传下载?

 就是下载文件时,不必重头开始下载,而是从指定的位置继续下载,这样的功能就做断点续传下载。断点续传的理解可以分为两部分:一部分是断点,一部分是续传下载。断点的由来是在下载过程中,将一个下载文件分成了多个部分,同时进行多个部分一起的下载,当某个时间点,任务被暂停了或因网络原因断网、或停电、程序闪退或退出等等影响,此时下载中断的位置就是断点了。续传就是当一个未完成的下载任务再次开始时,会从上次的断点继续传送下载。当然,在实际的业务开发中,就是把一个大文件事先分成多个小片段返回给前端。

简单介绍下HTTP断点续传原理

  PHP支持断点续传,主要依靠HTTP协议中 header HTTP_RANGE实现。HTTP断点续传原理Http头 Range、Content-Range()HTTP头中一般断点下载时才用到Range和Content-Range实体头,Range用户请求头中,指定第一个字节的位置和最后一个字节的位置,如(Range:200-300)Content-Range用于响应头请求下载整个文件。

不使用断点续传

get  /down.zip   http/1.1
accept: image/gif,image/x-xbitmap,image/jpeg,image/pjpeg,application/vnd.ms-excel,application/msword,application/vnd.ms-powerpoint
accept-language:zh-cn
accept-encoding:gzip,deflate
user-agent:mozilla/4.0(compatible;msie  5.01;windows nt 5.0)
connection:keep-alive


服务器收到请求后,按要求寻找请求的文件,提交文件的信息,然后返回给浏览器,返回信息如下:

HTTP/1.1  200   OK
content - length = 106788888
accept - ranges = bytes
date=mon, 30  apr   2021  12:12:11  gmt
etag=w/“02ca57e173c11:95b”
content - type = application/octet - stream
server = microsoft - iis /5.0
last-modified = mon, 30  apr  2021  12:12:11  gmt

使用断点续传

GET   /down.zip   HTTP/1.0
User - Agent : NetFox
RANGE: bytes = 2000070-
Accept:text/html,image/gif,image/jpeg,*;q=.2,*/*;q=.2

多了这么一行Range:bytes = 2000070-
这一行的意思就是告诉服务器down.zip这个文件从2000070字节开始传,前面的字节不用传了。
Range的完整格式是:

Range:bytes = startOffset - targetOffset/sum   [表示从startOffset读取,一直读取到targetOffset位置,读取总数为sum]
Range:bytes = startOffset - targetOffset   [字节总数也可以去掉]

服务器收到这个请求后,返回的信息如下:

HTTP/1.1   206    Partial    Content
content - length = 106788888
content - range = bytes   2000070 - 106788888 / 106788889 
date = mon,  30   apr    2021    12:55:20   gmt
etag = w/“02ca57e173c11:95b”
content - type = application / octet - stream
server = microsoft - iis / 5.0
last - modified = mon,   30   apr   2021  12:55:20   gmt

和前面服务器返回的信息比较一下,就会发现增加了一行:

Content - Range = bytes   2000070 - 106788888 / 106788889

返回的代码也改为206了,而不再是200了。

HTTP/1.1   206  Partial   Content

增加校验

 在实际场景中,会出现一种情况,即在终端发起续传请求时,URL对应的文件内容在服务端已经发生了变化,此时续传的数据肯定是错误的。如何解决这个问题呢?显然此时需要有一个标识文件唯一性的方法。
 在 RFC2616 中也有相应的定义,比如实现 Last-Modified 来标识文件的最后修改时间,这样既可判断出续传文件时是否已经发生过改动。同时 FC2616 中还定义有一个ETag 的头,可以使用 ETag 头来放置文件的唯一标识,比如文件的MD5值。
 终端在发起续传请求时应该在HTTP头中申明If-Match 或者 If-Modified-Since 字段,帮助服务端判别文件变化。
 另外RF2616中同时定义有一个If-Range头,终端如果在续传是使用If-Range。If-Range中的内容可以为最初收到的ETag头或是Last-Modified中的最后修改时候。服务端在收到续传请求时,通过If-Range中的内容进行校验,校验一致时返回206的续传回应,不一致时服务端则返回200回应,回应的内容为新的文件的全部数据。

Last-Modified

 If-Modified-Since,和 Last-Modified 一样都是用于记录页面最后修改时间的 HTTP 头信息,只是 Last-Modified 是由服务器往客户端发送的 HTTP 头,而 If-Modified-Since 则是由客户端往服务器发送的头,可以看到,再次请求本地存在的 cache 页面时,客户端会通过 If-Modified-Since 头将先前服务器端发过来的 Last-Modified 最后修改时间戳发送回去,这是为了让服务器端进行验证,通过这个时间戳判断客户端的页面是否是最新的,如果不是最新的,则返回新的内容,如果是最新的,则返回 304 告诉客户端其本地 cache 的页面或文件是最新的,于是客户端就可以直接从本地加载页面了,这样在网络上传输的数据就会大大减少,同时也减轻了服务器的负担。

Etag

 Etag(Etity Tags)主要为了解决 Last-Modified 无法解决的一些问题。
 1. 一些文件也许会周期性的更改,但是内容并不改变(仅改变修改时间),这时候我们并不希望客户端认为这个文件被修改了,而重新 GET 。
 2.某些文件修改非常频繁,例如:在秒以下的时间内进行修改(1s内修改了N次),If-Modified-Since 能检查到的粒度是 s 级的,这种修改无法判断(或者说 UNIX 记录 MTIME 只能精确到秒)。
 3.某些服务器不能精确的得到文件的最后修改时间。
 为此,HTTP/1.1 引入了 Etag。Etag 仅仅是一个和文件相关的标记,可以是一个版本标记,例如:v1.0.0;或者说“627-45235gfd56250”这么一串看起来很神秘的编码。但是 HTTP/1.1 标准并没有规定 Etag 的内容是什么或者说要怎么实现,唯一规定的是 Etag 需要放在 “” 内。

If-Range

用于判断实体是否发生改变,如果实体未改变,服务器发送客户端丢失的部分,否则发送整个实体。
一般格式:

If-Range:Etag | HTTP-Date

也就是说,If-Range 可以使用 Etag 或者 Last-Modified 返回的值。当没有 ETage 却有 Last-modified 时,可以把 Last-modified 作为 If-Range 字段的值。
例如:

If-Range:Etag | HTTP-Date

也就是说,If-Range 可以使用 Etag 或者 Last-Modified 返回的值。当没有 ETag 却有 Last-modified时,可以把 Last-modified 作为 If-Range 字段的值。
例如:

If-Range:“627-45235gfd56250”
If-Range:30   apr    2021    12:55:20   gmt

If-Range 必须与 Range 配套使用。如果请求报文中没有 Range,那么 If-Range 就会被忽略。如果服务器不支持 If-Range,那么 Range 也会被忽略。
如果请求报文中的 Etag 与服务器目标内容的 Etag 相等,即没有发生变化,那么应答报文的状态码为206。如果服务器目标内容发生了变化,那么应答报文的状态码为200.
用于校验的其他 HTTP 头信息:If-Match/If-None-Match、If-Modified-Since/If-Unmodified-Since。

工作原理

Etag 由服务器端生成,客户端通过 If-Range 条件判断请求来验证资源是否修改。请求一个文件的流程如下:
第一次请求:
 1.客户端发起 HTTP GET 请求一个文件。
 2.服务器处理请求,返回文件内容以及相应的 Header,其中包括 Etag (例如:627-45235gfd56250)(假设服务器支持 Etag 生成并已开启了 Etag)状态码为200。
第二次请求(断点续传):
 1.客户端发起 HTTP GET 请求一个文件,同时发送 If-Range (该头的内容就是第一次请求时服务器返回的 Etag:627-45235gfd56250)。
 2.服务器判断接收到的 Etag 和计算出来的 Etag 是否匹配,如果匹配,那么响应的状态码为206;否则,状态码为200。

接下来上代码:

<?php
/* php下载类,支持断点续传
   download: 下载文件
     setSpeed:  设置下载速度
     getRange: 获取header中Range
*/
class  FileDownload{
        private $_speed = 512;                //下载速度

        /** 下载
        *   @ param  String     $file            要下载的文件路径
        *   @ param  String     $name        文件名称,为空则与下载的文件名称一样
        *   @ param  boolean  $reload       是否开启断点续传   
        */
        public  function   download($file, $name=' ', $reload=false){
                    if(file_exists($file)){
                                    if($name==' '){
                                                    $name = basename($file);
                                    }
                                    $header_array = get_headers($file, true);
                                    //下载本地文件,获取文件大小
                                    if(!$header_array){
                                                    $file_size = filesize($file);
                                    }else{
                                                    $file_size = $header_array['Content-Length'];
                                    }
                                    $ranges = $this->getRange($file_size);
                                    $ua = $_SERVER['HTTP_USER_AGENT'];//判断是什么类型浏览器

                                    header('cache-control:public');
                                    header('content-type:application/octet-stream');
                                    header('content-disposition:attachment; filename='.$name);

                                    $encoded_filename = urlencode($name);
                                    $encoded_filename = str_replace("+","%20",$encoded_filename);

                                    //解决下载文件名乱码
                                    if(preg_match("/MSIE/",$ua) ||  preg_match("/Trident/", $ua)){
                                                header('Content-Disposition:attachment; filename=" ' .$encoded_filename . ' " ')
                                    }else if(preg_match("/Firefox", $ua)) {
                                                header('Content-Disposition: attachment; filename*="utf8\ '\ ' ' . $name . ' " ');
                                    }else if(preg_match("/Chrome/", $ua)) {
                                                header('Content-Disposition: attachment; filename=" ' . $encoded_filename . ' " ');
                                    } else{
                                                header('Content-Disposition: attachment; filename=" '.);
                                    }
                                    if($reload  &&  $ranges != null){       //使用续传
                                                header('HTTP/1.1   206   Partial  Content' );
                                                header('Accept-Ranges:bytes' );
                                                //剩余长度
                                                header(sprintf('content-length:%u',$ranges['end']-$ranges['start']));
                                                //range信息
                                                header(sprintf('content-range:bytes  %s-%s/%s', $ranges['start'], $ranges['end'], $file_size));
                                                //fp指针跳到断点位置
                                                fseek($fp, sprintf('%u', $ranges['start']));
                                    }else{
                                                header('HTTP/1.1   200   OK');
                                                header('content-length:'.$file_size);
                                    }

                                    while(!feof($fp)){
                                                echo   fread($fp,  round($this->_speed*1024,0));
                                                ob_flush();
                                              //sleep(1);             //用于测试,减慢下载速度
                                    }
                                    ($fp!=null)   &&   fclose($fp);
                    }else{
                                    return ' ';
                    }
        }

        /**   设置下载速度
        *    @ param   int   $speed
        */

        public  function  setSpeed($speed){
                    if(is_numberic($speed)   &&    $speed  >  16   &&   $speed < 4096){
                                        $this->_speed = $speed;
                    }
        }

        /**   获取header   range信息
        *    @ param     int    $file_size   文件大小
        *    @ return      Array
        */

        private   function  getRange($file_size){
                  if(isset($_SERVER['HTTP_RANGE'])  &&  !empty($_SERVER['HTTP_RANGE'])){
                                $range = $_SERVER['HTTP_RANGE'];
                                $range = preg_replace('/[\s|,].*/', ' ', $range);
                                $range = explode('-', substr($range, 6));
                                if(count($range) < 2){
                                                $range[1] = file_size;
                                }
                                $range = array_combine(array('start','end'), $range);
                                if(empty($range['start'])) {
                                                $range['start']  = 0;
                                }
                                if(empty($range['end'])) {
                                                $range['end'] = $file_size;  
                                }
                                return   $range;
                    }
                    return  null;
        }
}

$file  =  'down.zip';
$name  =  time().'.zip';
$obj  =  new  FileDownload();
$flag  = $obj->download($file, $name);
//$flag  =  $obj->download($file, $name, true);   //断点续传

if(!$flag){
            echo  'file  not  exists';
}

?>

标签:HTTP,range,Modified,header,Range,Etag,PHP,断点,下载
来源: https://blog.51cto.com/bin06/2633807