PHP怎样处理大文件上传？分片上传实现方法

雪夜

发布时间：2025-08-05 17:37:01

795人浏览过

来源于php中文网

原创

分片上传是处理php大文件上传最稳妥的方法，它通过将文件切分为多个小块逐个上传并最终合并，有效规避了传统上传的限制。传统php上传的瓶颈主要在于php.ini中的upload_max_filesize、post_max_size、memory_limit和max_execution_time等参数限制，以及网络不稳定导致的上传中断问题。前端实现上，使用javascript的file对象和slice()方法将文件按固定大小（如1mb）切片，通过formdata封装每个分片，并附带chunk_index、total_chunks和file_identifier等元信息，利用fetch或xmlhttprequest异步发送，同时可监听progress事件实现上传进度显示，并通过localstorage记录已上传分片实现断点续传。服务器端php接收每个分片后，将其保存在以file_identifier命名的独立临时目录中，文件命名为分片索引（如0.part），并在每次接收后检查是否所有分片均已上传。当全部分片到位时，按顺序读取各分片内容，使用fopen('ab')逐块写入最终文件，避免内存溢出，合并完成后删除临时文件和目录。关键优化包括：使用二进制流式读写提升合并效率、确保文件唯一标识防止冲突、增加文件哈希校验完整性、采用临时文件+原子重命名保障合并原子性，并考虑并发上传的锁机制或去重策略。1. 切片：前端按固定大小切分文件并携带元数据上传；2. 上传：逐片异步发送并支持进度反馈；3. 接收：后端按标识分类存储分片至临时目录；4. 合并：确认所有分片到达后按序流式合并；5. 清理：合并成功后删除临时文件与目录；6. 增强：加入断点续传、错误重试、完整性校验与并发控制机制，确保系统稳定可靠。

PHP怎样处理大文件上传？分片上传实现方法

处理PHP大文件上传，分片上传是目前最稳妥也最主流的方法。它将一个大文件拆分成多个小块，逐个上传到服务器，最后再在服务器端将这些小块拼接起来，有效规避了传统上传方式的诸多限制和网络不稳定性。

解决方案

要实现分片上传，核心思路就是将文件在客户端进行切片，然后逐个上传到服务器，服务器端接收到每个分片后，将其保存为临时文件，并最终在所有分片都上传完成后，将这些临时文件合并成原始文件。

客户端实现（以JavaScript为例）：

立即学习“PHP免费学习笔记（深入）”；

文件选择与切片： 用户选择文件后，通过JavaScript的
```
File
```
对象获取文件信息。利用
```
File.prototype.slice()
```
方法将大文件切割成固定大小的块（例如，每块1MB或4MB）。
逐片上传： 遍历这些文件块，为每个块创建一个
```
FormData
```
对象，将文件块、当前块的索引、总块数、文件唯一标识（如文件名+文件大小的哈希值）等信息添加到
```
FormData
```
中。
异步发送： 使用
```
XMLHttpRequest
```
或
```
fetch
```
API将每个
```
FormData
```
对象异步发送到服务器的上传接口。在发送过程中，可以监听
```
progress
```
事件来显示上传进度。
断点续传： 客户端需要记录已上传的块信息（例如，存储在
```
localStorage
```
中），当上传中断时，下次可以从中断的块继续上传，而不是从头开始。这需要服务器端能识别并跳过已存在的块。

服务器端实现（以PHP为例）：

接收分片： PHP脚本接收通过
```
POST
```
请求发送过来的文件分片。通常，每个请求会包含一个文件分片（
```
$_FILES['chunk']
```
）以及相关元数据（如
```
chunkIndex
```
、
```
totalChunks
```
、
```
fileIdentifier
```
）。
临时存储： 将接收到的文件分片保存到服务器上的一个临时目录中。这个目录可以根据
```
fileIdentifier
```
来命名，确保每个文件的分片都存储在各自独立的子目录中。分片文件可以命名为
```
fileIdentifier_chunkIndex
```
。
合并逻辑：
- 每次成功接收并保存一个分片后，更新该文件已上传分片的记录（例如，在数据库或缓存中记录已上传的
```
chunkIndex
```
  ）。
- 当服务器检测到所有分片（即
```
totalChunks
```
  个分片）都已成功上传时，触发合并操作。
- 合并操作就是按顺序读取所有分片文件，并将它们的内容追加写入到一个最终的文件中。可以使用
```
fopen
```
  以
```
ab
```
  （追加二进制）模式打开目标文件，然后用
```
fwrite
```
  将每个分片的内容写入。
- 合并完成后，将临时分片文件及其所在的临时目录删除。
- 重要： 在合并过程中，确保文件锁定机制，避免并发请求导致的文件损坏。

传统PHP文件上传的瓶颈在哪里？

说实话，PHP直接上传大文件，你很快就会遇到各种“墙”。最直接的，也是最常见的，就是

php.ini

里那几个参数：

upload_max_filesize

（允许上传的最大文件大小）、

post_max_size

（POST请求的最大数据量）以及

memory_limit

（脚本可用的最大内存）。这些默认值通常都很小，几十兆顶天了，稍微大点的文件就直接报错。你当然可以调大它们，但问题是，调得太大并不总是好事，甚至可能让你的服务器变得脆弱，容易被恶意请求耗尽资源。

除此之外，网络环境也是个大问题。你想啊，一个几百兆甚至几个G的文件，在网络不稳定的情况下，一次性传上去，中途只要稍微有点波动，连接就可能断开，然后？整个上传过程就得重来一遍。这用户体验简直是灾难。而且，服务器端的

max_execution_time

（脚本最大执行时间）也会限制上传时间，文件太大，上传时间一长，脚本就超时了。这些限制加起来，就决定了传统方式在大文件面前几乎是寸步难行。分片上传，本质上就是把一个大问题拆解成无数个小问题来解决，每个小问题都更容易处理，失败了也只影响一小部分，而不是全部。

站长俱乐部购物系统

功能介绍：1、模块化的程序设计，使得前台页面设计与程序设计几乎完全分离。在前台页面采用过程调用方法。在修改页面设计时只需要在相应位置调用设计好的过程就可以了。另外，这些过程还提供了不同的调用参数，以实现不同的效果；2、阅读等级功能，可以加密产品，进行收费管理；3、可以完全可视化编辑文章内容，所见即所得；4、无组件上传文件，服务器无需安装任何上传组件，无需支持FSO，即可上传文件。可限制文件上传的类

下载

前端如何将大文件切片并发送？

前端实现文件切片和发送，其实并不复杂，但细节决定成败。核心是JavaScript的

File

对象和

Blob.prototype.slice()

方法。当你通过

获取到文件后，它就是一个

File

对象，而

File

对象继承自

Blob

。

slice(start, end)

方法能让你轻松地从文件中“切”出一小块二进制数据。

我的做法通常是这样的：先确定一个合适的切片大小，比如1MB。然后用一个循环，从文件开头开始，每次切出指定大小的数据块，直到文件末尾。每个切片，我们都可以把它封装到一个

FormData

对象里，就像你平时上传小文件那样。

// 伪代码示例，实际应用需要更健壮的错误处理和进度管理
function uploadFileInChunks(file) {
    const chunkSize = 1 * 1024 * 1024; // 1MB
    let currentChunk = 0;
    const totalChunks = Math.ceil(file.size / chunkSize);
    const fileIdentifier = file.name + '-' + file.size + '-' + file.lastModified; // 简单唯一标识

    const uploadNextChunk = () => {
        if (currentChunk < totalChunks) {
            const start = currentChunk * chunkSize;
            const end = Math.min(file.size, start + chunkSize);
            const chunk = file.slice(start, end);

            const formData = new FormData();
            formData.append('file_chunk', chunk);
            formData.append('file_identifier', fileIdentifier);
            formData.append('chunk_index', currentChunk);
            formData.append('total_chunks', totalChunks);

            fetch('/upload-chunk.php', {
                method: 'POST',
                body: formData
            })
            .then(response => response.json())
            .then(data => {
                if (data.success) {
                    console.log(`Chunk ${currentChunk} uploaded.`);
                    currentChunk++;
                    uploadNextChunk(); // 上传下一个分片
                } else {
                    console.error(`Chunk ${currentChunk} failed:`, data.message);
                    // 考虑重试机制
                }
            })
            .catch(error => {
                console.error('Network error during chunk upload:', error);
                // 考虑重试机制
            });
        } else {
            console.log('All chunks uploaded. Server will merge.');
            // 通知服务器合并，或者服务器自己判断完成
        }
    };

    uploadNextChunk(); // 开始上传
}

这里面，

file_identifier

非常关键，它能让服务器知道这些散落的块是属于哪个文件的。而

chunk_index

和

total_chunks

则告诉服务器当前是第几块，总共有多少块。有了这些信息，服务器才能正确地接收和拼接。前端还可以加入进度条，通过监听

XMLHttpRequest

的

progress

事件来更新上传进度，给用户一个直观的反馈。断点续传的话，就需要前端在本地存储（如

localStorage

）已上传的

chunk_index

，下次加载时先查询服务器，或者直接从本地记录的下一个未上传的块开始。

PHP后端如何高效接收与合并文件分片？

PHP后端处理分片，核心是

move_uploaded_file

和文件操作函数。每次前端发送一个分片过来，PHP都会把它当成一个普通的文件上传请求来处理。

 false, 'message' => 'File upload error.']);
    exit;
}

$tempDir = 'uploads/chunks/' . $fileIdentifier . '/';
if (!is_dir($tempDir)) {
    mkdir($tempDir, 0777, true); // 确保目录存在
}

$chunkFilePath = $tempDir . $chunkIndex . '.part'; // 临时分片文件命名

if (move_uploaded_file($uploadedFile['tmp_name'], $chunkFilePath)) {
    // 检查所有分片是否都已上传
    $uploadedCount = 0;
    for ($i = 0; $i < $totalChunks; $i++) {
        if (file_exists($tempDir . $i . '.part')) {
            $uploadedCount++;
        }
    }

    if ($uploadedCount === $totalChunks) {
        // 所有分片都已上传，开始合并
        $finalFileName = str_replace(['/', '\\', '..'], '', $fileIdentifier); // 简单净化文件名
        $finalFilePath = 'uploads/final/' . $finalFileName;

        $outputHandle = fopen($finalFilePath, 'wb'); // 以二进制写入模式打开最终文件

        if ($outputHandle === false) {
            echo json_encode(['success' => false, 'message' => 'Could not open final file for writing.']);
            exit;
        }

        for ($i = 0; $i < $totalChunks; $i++) {
            $partPath = $tempDir . $i . '.part';
            $inputHandle = fopen($partPath, 'rb');
            if ($inputHandle === false) {
                // 某个分片丢失或无法读取，这通常不应该发生如果uploadedCount检查通过
                fclose($outputHandle);
                unlink($finalFilePath); // 删除不完整的文件
                echo json_encode(['success' => false, 'message' => 'Missing chunk ' . $i]);
                exit;
            }
            while (!feof($inputHandle)) {
                fwrite($outputHandle, fread($inputHandle, 8192)); // 每次读取8KB写入
            }
            fclose($inputHandle);
            unlink($partPath); // 删除已合并的分片
        }
        fclose($outputHandle);
        rmdir($tempDir); // 删除临时目录

        echo json_encode(['success' => true, 'message' => 'File merged successfully.', 'filePath' => $finalFilePath]);
    } else {
        echo json_encode(['success' => true, 'message' => 'Chunk uploaded, waiting for others.']);
    }
} else {
    echo json_encode(['success' => false, 'message' => 'Failed to move uploaded chunk.']);
}
?>

这段PHP代码展示了一个基本流程：接收分片，保存到以文件ID命名的临时目录中，文件名就是分片索引。当所有分片都到齐后，就按顺序读取并写入到最终文件。这里有几个点值得注意：

临时目录管理： 每个大文件都应该有自己独立的临时目录来存放分片，避免不同文件的分片混淆。记得在合并完成后清理这些临时目录和文件。
文件命名： 临时分片文件最好以其索引命名（如
```
0.part
```
,
```
1.part
```
），这样合并时可以直接按数字顺序读取。
合并效率： 在合并时，使用
```
fopen
```
和
```
fwrite
```
进行二进制读写通常比
```
file_get_contents
```
和
```
file_put_contents
```
更适合处理大文件，因为它不会一次性将整个分片内容加载到内存中。
原子性： 文件合并是一个关键步骤，如果中途失败，可能会留下不完整的文件。一个更健壮的做法是先合并到一个临时文件，成功后再原子性地重命名到最终文件名。
错误和异常： 实际项目中，你需要更细致的错误处理，比如分片上传失败的重试机制、服务器磁盘空间不足的检查、文件完整性校验（比如计算MD5或SHA1哈希值，前端上传后和后端合并后的文件做对比）。
并发问题： 如果多个用户同时上传大文件，或者同一个用户在不同浏览器标签页上传同一个文件，可能会有并发写入临时目录的问题。通常，文件标识符足够独特就能避免大部分冲突，但更严格的系统可能会引入锁机制。