PHP搭建大文件切割分块上传功能

118次阅读

共计 5553 个字符，预计需要花费 14 分钟才能阅读完成。

背景

在网站开发中，文件上传是很常见的一个功能。相信很多人都会遇到这种情况，想传一个文件上去，然后网页提示“该文件过大”。因为一般情况下，我们都需要对上传的文件大小做限制，防止出现意外的情况。
但是在有些业务场景中，大文件上传又是必须的，比如邮箱附件，或者内部 OA 等等。

问题

服务端为什么不能直接传大文件？跟 php.ini 里面的几个配置有关

upload_max_filesize = 2M //PHP 最大能接受的文件大小 
post_max_size = 8M //PHP 能收到的最大 POST 值 '
memory_limit = 128M // 内存上限 
max_execution_time = 30 // 最大执行时间

当然不能简单粗暴的把上面几个值调大，否则服务器内存资源吃光是迟早的问题。

解决思路

好在 HTML5 开放了新的 FILE API，也可以直接操作二进制对象，我们可以直接在浏览器端实现文件切割，按照以前的做法就得用 Flash 的方案，实现起来会麻烦很多。

JS 思路
1. 监听上传按钮的 onchange 事件
2. 获取文件的 FILE 对象
3. 把文件的 FILE 对象进行切割，并且附加到 FORMDATA 对象中
4. 把 FORMDATA 对象通过 AJAX 发送到服务器
5. 重复 3、4 步骤，直到文件发送完。

PHP 思路
1. 建立上传文件夹
2. 把文件从上传临时目录移动到上传文件夹
3. 所有的文件块上传完成后，进行文件合成
4. 删除文件夹
5. 返回上传后的文件路径

DEMO 代码

前端部分代码

<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport"
          content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>www.linuxidc.com</title>
    <style>
        #progress{width: 300px;
            height: 20px;
            background-color:#f7f7f7;
            box-shadow:inset 0 1px 2px rgba(0,0,0,0.1);
            border-radius:4px;
            background-image:linear-gradient(to bottom,#f5f5f5,#f9f9f9);
        }

        #finish{background-color: #149bdf;
            background-image:linear-gradient(45deg,rgba(255,255,255,0.15) 25%,transparent 25%,transparent 50%,rgba(255,255,255,0.15) 50%,rgba(255,255,255,0.15) 75%,transparent 75%,transparent);
            background-size:40px 40px;
            height: 100%;
        }
        form{margin-top: 50px;
        }
    </style>
</head>
<body>
<div id="progress">
    <div id="finish" style="width: 0%;" progress="0"></div>
</div>
<form action="./upload.php">
    <input type="file" name="file" id="file">
    <input type="button" value="停止" id="stop">
</form>
<script>
    var fileForm = document.getElementById("file");
    var stopBtn = document.getElementById('stop');
    var upload = new Upload();

    fileForm.onchange = function(){upload.addFileAndSend(this);
    }

    stopBtn.onclick = function(){this.value = "停止中";
        upload.stop();
        this.value = "已停止";
    }

    function Upload(){var xhr = new XMLHttpRequest();
        var form_data = new FormData();
        const LENGTH = 1024 * 1024;
        var start = 0;
        var end = start + LENGTH;
        var blob;
        var blob_num = 1;
        var is_stop = 0
        // 对外方法，传入文件对象 
        this.addFileAndSend = function(that){var file = that.files[0];
            blob = cutFile(file);
            sendFile(blob,file);
            blob_num  += 1;
        }
        // 停止文件上传 
        this.stop = function(){xhr.abort();
            is_stop = 1;
        }
        // 切割文件 
        function cutFile(file){var file_blob = file.slice(start,end);
            start = end;
            end = start + LENGTH;
            return file_blob;
        };
        // 发送文件 
        function sendFile(blob,file){var total_blob_num = Math.ceil(file.size / LENGTH);
            form_data.append('file',blob);
            form_data.append('blob_num',blob_num);
            form_data.append('total_blob_num',total_blob_num);
            form_data.append('file_name',file.name);

            xhr.open('POST','./upload.php',false);
            xhr.onreadystatechange  = function () {var progress;
                var progressObj = document.getElementById('finish');
                if(total_blob_num == 1){progress = '100%';
                }else{progress = Math.min(100,(blob_num/total_blob_num)* 100 ) +'%';
                }
                progressObj.style.width = progress;
                var t = setTimeout(function(){if(start < file.size && is_stop === 0){blob = cutFile(file);
                        sendFile(blob,file);
                        blob_num  += 1;
                    }else{setTimeout(t);
                    }
                },1000);
            }
            xhr.send(form_data);
        }
    }

</script>
</body>
</html>

PHP 部分代码

<?php
class Upload{private $filepath = './upload'; // 上传目录 
    private $tmpPath;  //PHP 文件临时目录 
    private $blobNum; // 第几个文件块 
    private $totalBlobNum; // 文件块总数 
    private $fileName; // 文件名 

    public function __construct($tmpPath,$blobNum,$totalBlobNum,$fileName){
        $this->tmpPath =  $tmpPath;
        $this->blobNum =  $blobNum;
        $this->totalBlobNum =  $totalBlobNum;
        $this->fileName =  $fileName;
        
        $this->moveFile();
        $this->fileMerge();}
    
    // 判断是否是最后一块，如果是则进行文件合成并且删除文件块 
    private function fileMerge(){if($this->blobNum == $this->totalBlobNum){$blob = '';
            for($i=1; $i<= $this->totalBlobNum; $i++){$blob .= file_get_contents($this->filepath.'/'. $this->fileName.'__'.$i);
            }
            file_put_contents($this->filepath.'/'. $this->fileName,$blob);
           $this->deleteFileBlob();}
    }
    
   // 删除文件块 
    private function deleteFileBlob(){for($i=1; $i<= $this->totalBlobNum; $i++){@unlink($this->filepath.'/'. $this->fileName.'__'.$i);
        }
    }
    
    // 移动文件 
    private function moveFile(){$this->touchDir();
        $filename = $this->filepath.'/'. $this->fileName.'__'.$this->blobNum;
        move_uploaded_file($this->tmpPath,$filename);
    }
    
    //API 返回数据 
    public function apiReturn(){if($this->blobNum == $this->totalBlobNum){if(file_exists($this->filepath.'/'. $this->fileName)){$data['code'] = 2;
                    $data['msg'] = 'success';
                    $data['file_path'] = 'http://'.$_SERVER['HTTP_HOST'].dirname($_SERVER['DOCUMENT_URI']).str_replace('.','',$this->filepath).'/'. $this->fileName;
                }
        }else{if(file_exists($this->filepath.'/'. $this->fileName.'__'.$this->blobNum)){$data['code'] = 1;
                    $data['msg'] = 'waiting for all';
                    $data['file_path'] = '';
                }
        }
        header('Content-type: application/json');
        echo json_encode($data);
    }
    
    // 建立上传文件夹 
    private function touchDir(){if(!file_exists($this->filepath)){return mkdir($this->filepath);
        }
    }
}

// 实例化并获取系统变量传参 
$upload = new Upload($_FILES['file']['tmp_name'],$_POST['blob_num'],$_POST['total_blob_num'],$_POST['file_name']);
// 调用方法，返回结果 
$upload->apiReturn();

存在的问题

这只是一个简单的 DEMO，有很多地方需要改进，比如上传的文件夹与临时文件放在一起，用户中途取消也没有发请求进行清理，容易造成文件冗余。JS 采用的是同步模型，文件需要一块一块按顺序上传，会导致整个浏览器在上传的过程中出于堵塞的状态，按了按钮可能需要几秒钟才能反应过来，用户体验不好。真正需要产品化的时候就要综合考虑多种情况，当然作为一个示例，引导大家了解分块上传的思路还是不错的。

Ubuntu 16.10 开启 PHP 错误提示 http://www.linuxidc.com/Linux/2016-10/136537.htm

Ubuntu 16.04 环境中安装 PHP7.0 Redis 扩展 http://www.linuxidc.com/Linux/2016-09/135631.htm

在 CentOS 7.x / Fedora 21 上面体验 PHP 7.0 http://www.linuxidc.com/Linux/2015-05/117960.htm

CentOS 6.3 安装 LNMP (PHP 5.4,MyySQL5.6) http://www.linuxidc.com/Linux/2013-04/82069.htm

在部署 LNMP 的时候遇到 Nginx 启动失败的 2 个问题 http://www.linuxidc.com/Linux/2013-03/81120.htm

PHP 源码安装、简单配置、测试及连接数据库 http://www.linuxidc.com/Linux/2016-10/135977.htm

《细说 PHP》高清扫描 PDF+ 光盘源码 + 全套教学视频 http://www.linuxidc.com/Linux/2014-03/97536.htm

CentOS 7.2 下编译安装 PHP7.0.10+MySQL5.7.14+Nginx1.10.1 http://www.linuxidc.com/Linux/2016-09/134804.htm

PHP 的详细介绍 ：请点这里
PHP 的下载地址 ：请点这里

本文永久更新链接地址 ：http://www.linuxidc.com/Linux/2017-01/139133.htm

正文完

星哥说事-微信公众号