处理大文件上传是网络开发中的一个常见挑战,由于服务器限制或网络不稳定等因素,常常会导致文件上传超时或上传失败。文件切片/分块上传提供了一种稳健的解决方案,它将大文件分解成较小的、易于管理的片(块),然后按顺序上传。这种方法不仅能提高文件上传的可靠性,还能实现暂停、恢复和重试功能。本教程将为您讲解使用 PHP 在服务器端实现分块文件上传的方法。
先决条件
- PHP 和 JavaScript 基础知识
- 一台已安装并配置好 PHP 与 WEB 服务的服务器
- 熟悉客户端文件上传机制
步骤 1:编写客户端上传代码
在服务端处理上传之前,您需要先准备客户端代码,以便将文件分割成块并发送。虽然本文的重点是 PHP 端,但了解客户端逻辑也至关重要。您可以使用 JavaScript 的Blob.slice()
方法分割文件,并使用FormData
通过 AJAX 发送文件块。可以参考本站的JS 切片/分块上传大文件一文,该文中已给出了相关的前端示例代码,需要注意的是,要将代码中的/upload-endpoint
修改为你的 php 处理网址。
步骤 2:在服务器上接收数据块
客户端发送的每个分块都需要由服务器接收并临时存储,直到文件的所有部分都上传完毕。下面是一个简单的 PHP 脚本,用于处理接收到的数据块:
<?php
$targetDir = "uploads/chunks"; // 文件分块存储目录
$targetFile = $targetDir . '/' . basename($_FILES["file"]["name"]);
// 确认目录存在,否则创建目录并赋予权限
if (!file_exists($targetDir)) {
mkdir($targetDir, 0777, true);
}
// 将上传的片段移至存储目录
if (move_uploaded_file($_FILES["file"]["tmp_name"], $targetFile)) {
echo "The file " . htmlspecialchars(basename($_FILES["file"]["name"])) . " has been uploaded.";
} else {
echo "零五网[www.02405.com]提示:抱歉,上传文件时出现错误。";
}
该脚本假定每个数据块都是作为一个单独的请求接收的。它将接收到的数据块移动到指定目录。实际开发过程中,你应该增加一个索引机制来识别每一个切片/分块,通常是通过额外的 POST 数据(如文件标识符、块索引)来处理。
步骤 3:合并文件块
所有文件块上传完成后,下一步需要将它们合并生成原始文件。这可以由一个单独的请求触发,表明上传过程已经完成,也可以通过检查是否已收到所有预期的文件块来自动检测。
本文只分享在 PHP 中合并数据块的方法:
<?php
$targetDir = "uploads/chunks";
$finalFile = "uploads/final/" . $_POST['fileName']; // 最终的文件路径和文件名称
// 打开最终文件句柄
$fp = fopen($finalFile, 'wb');
// 假设文件块按顺序命名(如:file.part1、file.part2......)
for ($i=0; $i < $_POST['totalChunks']; $i++) {
$chunkFile = $targetDir . '/' . $_POST['fileName'] . ".part" . $i;
// 读写当前数据块
$chunk = file_get_contents($chunkFile);
fwrite($fp, $chunk);
// 可选项:合并后删除文件切片/块
unlink($chunkFile);
}
// 关闭文件句柄
fclose($fp);
echo "上传及合并完成";
该脚本假定所有数据块按顺序排列,然后根据顺序读取并将其内容写入最终文件。实际开发过程中根据客户端的实现情况调整命名约定即可。
步骤 4:安全和验证
处理文件上传需要慎重考虑安全性和数据验证:
- 在客户端和服务器同时端验证文件类型,防止恶意上传。
- 对中断的上传实施错误处理,包括清理部分上传。
- 通过
.htaccess
限制或将其置于网络根目录之外,确保临时存储目录的安全。