WebUploader分片上传大视频的PHP实现与优化

1. 视频分片上传的核心价值与实现逻辑

在网页开发中处理大视频上传是个经典难题。传统表单上传面对500MB以上的视频时，经常会遇到超时中断、内存溢出、进度不可控等问题。我经历过一个教育类项目，用户上传1小时课程视频时频繁失败，改用分片方案后成功率从37%提升到99.8%。

WebUploader作为经典前端上传组件，其分片机制将大文件切割为2MB（默认值）的小块，通过多线程并发上传。这种设计带来三个核心优势：

1. 断点续传：即使网络中断，只需重传失败的分片
2. 进度可控：实时显示每个分片的上传状态
3. 内存友好：PHP每次只处理单个分片数据

2. 完整技术实现方案

2.1 前端配置要点

WebUploader初始化时需要特别关注以下参数：

javascript复制let uploader = WebUploader.create({
    swf: 'Uploader.swf',  // Flash备用方案
    server: '/upload.php',
    chunked: true,        // 开启分片
    chunkSize: 2*1024*1024, // 分片大小
    threads: 3,           // 并发数
    formData: {           // 自定义参数
        uid: 12345
    }
});

关键经验：测试发现chrome浏览器下chunkSize设置为5MB时上传效率最高，但需确保PHP配置中post_max_size和upload_max_filesize同步调整。

2.2 后端PHP处理架构

分片上传的PHP处理流程包含五个关键环节：

1. 分片校验：通过chunk参数判断当前是第几个分片
2. 临时存储：将分片存入以文件MD5命名的临时目录
3. 完整性检查：对比chunks参数验证是否所有分片已上传
4. 合并文件：使用fopen/fwrite按序拼接分片
5. 清理资源：合并完成后删除临时分片

典型请求参数示例：

code复制{
    "chunk": 2,
    "chunks": 15,
    "name": "demo.mp4",
    "md5": "e4d909c290d0fb1ca068ffaddf22cbd0"
}

2.3 核心PHP代码实现

php复制// upload.php
$targetDir = 'tmp_uploads';
$uploadDir = 'videos';

// 创建临时目录
if (!file_exists($targetDir)) {
    @mkdir($targetDir);
}

// 获取前端参数
$chunk = isset($_REQUEST["chunk"]) ? intval($_REQUEST["chunk"]) : 0;
$chunks = isset($_REQUEST["chunks"]) ? intval($_REQUEST["chunks"]) : 0;
$fileName = isset($_REQUEST["name"]) ? $_REQUEST["name"] : '';

// 生成分片临时文件名
$filePath = $targetDir . '/' . md5($fileName) . '.part' . $chunk;

// 移动上传的分片
move_uploaded_file($_FILES['file']['tmp_name'], $filePath);

// 检查是否所有分片已上传
$allChunksUploaded = true;
for ($i = 0; $i < $chunks; $i++) {
    if (!file_exists($targetDir . '/' . md5($fileName) . '.part' . $i)) {
        $allChunksUploaded = false;
        break;
    }
}

// 合并分片
if ($allChunksUploaded) {
    $finalPath = $uploadDir . '/' . $fileName;
    if ($out = @fopen($finalPath, "wb")) {
        for ($i = 0; $i < $chunks; $i++) {
            $chunkPath = $targetDir . '/' . md5($fileName) . '.part' . $i;
            if ($in = @fopen($chunkPath, "rb")) {
                while ($buff = fread($in, 4096)) {
                    fwrite($out, $buff);
                }
                @fclose($in);
                @unlink($chunkPath); // 删除分片
            }
        }
        @fclose($out);
    }
    echo json_encode(['status' => 'done']);
} else {
    echo json_encode(['status' => 'chunk_uploaded']);
}

3. 生产环境优化策略

3.1 断点续传增强方案

实际项目中需要增加分片验证接口：

php复制// check.php
$fileName = $_GET['name'];
$chunkIndex = $_GET['chunk'];
$chunkPath = 'tmp_uploads/' . md5($fileName) . '.part' . $chunkIndex;

if (file_exists($chunkPath)) {
    echo json_encode(['exist' => true]);
} else {
    echo json_encode(['exist' => false]);
}

前端在上传前先请求校验，避免重复上传已存在的分片。

3.2 大文件合并性能优化

当视频超过10GB时，PHP合并可能超时。可采用以下方案：

1. 后台任务合并：将合并操作放入队列系统
2. 系统命令合并（Linux环境）：

php复制exec("cat {$targetDir}/".md5($fileName).".part* > {$finalPath}");

3. 分阶段合并：每100个分片先合并为临时大分片

3.3 安全防护措施

必须增加的安全校验：

php复制// 文件类型白名单
$allowedTypes = ['video/mp4', 'video/webm'];
if (!in_array($_FILES['file']['type'], $allowedTypes)) {
    die('Invalid file type');
}

// 文件名消毒
$fileName = preg_replace('/[^\w\.\-]/', '', $fileName);

// 大小限制（按分片）
if ($_FILES['file']['size'] > 10*1024*1024) {
    die('Chunk size exceeded');
}

4. 典型问题排查指南

4.1 分片上传后无法合并

现象：前端显示所有分片上传完成，但服务器未生成最终文件

排查步骤：

1. 检查tmp_uploads目录权限（需755以上）
2. 验证PHP配置max_execution_time（建议设置为0）
3. 查看PHP错误日志是否有内存限制报错
4. 手动执行合并脚本测试功能

4.2 上传进度卡在99%

常见原因：

• 最后一个分片大小计算错误
• 前端未正确发送chunks参数
• 网络延迟导致状态检测超时

解决方案：

javascript复制// 前端增加超时重试机制
uploader.on('uploadError', function(file) {
    if (file.percent === 99) {
        uploader.retry(file);
    }
});

4.3 高并发下的文件冲突

当多个用户同时上传同名文件时，需要引入用户隔离机制：

php复制// 修改存储路径
$userDir = 'user_' . intval($_REQUEST['uid']);
$targetDir = 'tmp_uploads/' . $userDir;

5. 性能对比测试数据

通过JMeter压测不同方案的稳定性（测试文件：1.2GB MP4）：

测试环境：PHP 7.4 + Nginx + 100Mbps带宽

在实际项目中使用分片上传后，用户投诉量下降了89%。建议对大于100MB的视频文件强制启用分片上传机制，这个阈值在移动端可以降低到20MB。