讲师中心 微信公众号

工具推荐

视频效率加速
SoundView
SoundView

字幕擦除翻译、配音口型同步

Seko
Seko

AI短剧一键生成成片

AniShort
AniShort

AI短剧协同制作平台

updream

一键生成高质量推广成片

PHP如何实现文件的分片上传?

夜敏吖_8078

夜敏吖_8078

发布时间:2026-11-22 11:56:03

|

867人浏览过

|

来源于php中文网

原创

php实现文件分片上传的核心做法是前端将大文件切割为多个块并附带元数据依次post到服务器,后端通过接收到的`chunk_index`、`total_chunks`和`file_id`等参数将每个块写入临时目录,待所有块接收完毕后合并为一个完整的临时文件,最后将其移动至目标存储路径。具体操作中,需确保每次请求都携带唯一的`file_id`以关联同一文件的各个分片,并在处理完最后一个分片时执行合并逻辑,从而保证数据的完整性和上传的可靠性。

PHP如何实现文件的分片上传?

如何设计API接口以接收单个分片数据

接收分片的关键在于验证请求中的元数据是否完整,并将二进制流安全地写入磁盘。接口通常接受`file_id`、`chunk_index`、`total_chunks`以及分片文件本身,后端代码需检查这些字段是否存在,防止恶意或错误的请求导致数据混乱。对于每个分片,我们创建一个以`file_id`和`chunk_index`命名的临时文件,将`$_FILES`中的数据直接复制进去,这样即使某个分片上传失败,也不会影响其他分片的存储,便于后续重试机制的处理。

PHP如何实现文件的分片上传?

<?php
// upload_chunk.php
header('Content-Type: application/json');

if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
    echo json_encode(['error' => 'Method not allowed']);
    exit;
}

$fileId = $_POST['file_id'] ?? '';
$chunkIndex = intval($_POST['chunk_index'] ?? -1);
$totalChunks = intval($_POST['total_chunks'] ?? 0);

if (empty($fileId) || $chunkIndex < 0 || $totalChunks <= 0) {
    echo json_encode(['error' => 'Missing metadata']);
    exit;
}

if (!isset($_FILES['chunk'])) {
    echo json_encode(['error' => 'No file chunk received']);
    exit;
}

$uploadDir = sys_get_temp_dir() . '/uploads/' . $fileId;
if (!is_dir($uploadDir)) {
    mkdir($uploadDir, 0777, true);
}

$chunkFile = $uploadDir . '/chunk_' . $chunkIndex;
if (move_uploaded_file($_FILES['chunk']['tmp_name'], $chunkFile)) {
    echo json_encode(['status' => 'ok', 'chunk' => $chunkIndex]);
} else {
    echo json_encode(['error' => 'Failed to save chunk']);
}
?>

上述代码展示了基本的分片接收逻辑。它首先校验了必要的POST参数,然后构建了基于`file_id`的独立目录结构。使用`move_uploaded_file`函数将PHP生成的临时文件移动到指定位置,这是最安全的做法,因为它能自动处理权限检查和临时文件清理。如果保存成功,返回状态码供前端确认;如果失败,前端可根据错误信息进行重试。这种设计确保了每个分片都是独立的实体,降低了单点故障对整体上传任务的影响。

立即学习“PHP免费学习笔记(深入)”;

Build MCP servers and clients for PHP applications with the official PHP SDK
Build MCP servers and clients for PHP applications with the official PHP SDK

使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。

下载

如何判断所有分片已就绪并合并文件

当所有分片上传完成后,前端会发起一个合并请求,或者在后端检测到最后一个分片到达时触发合并。我们需要一个专门的接口来检查进度或直接执行合并。合并过程涉及读取该`file_id`目录下所有的`chunk_*`文件,按照`chunk_index`的顺序依次读取内容并追加到一个新的完整文件中。在合并开始前,应再次验证分片数量是否与`total_chunks`一致,防止因网络波动导致的分片丢失。合并完成后,将生成的完整文件移动到最终的存储目录,并清理临时目录下的所有分片文件,释放磁盘空间。

PHP如何实现文件的分片上传?

<?php
// merge_file.php
header('Content-Type: application/json');

$fileId = $_POST['file_id'] ?? '';
$totalChunks = intval($_POST['total_chunks'] ?? 0);

if (empty($fileId) || $totalChunks <= 0) {
    echo json_encode(['error' => 'Invalid parameters']);
    exit;
}

$uploadDir = sys_get_temp_dir() . '/uploads/' . $fileId;
if (!is_dir($uploadDir)) {
    echo json_encode(['error' => 'Upload directory not found']);
    exit;
}

// 检查所有分片是否存在
for ($i = 0; $i < $totalChunks; $i++) {
    if (!file_exists($uploadDir . '/chunk_' . $i)) {
        echo json_encode(['error' => 'Missing chunk ' . $i]);
        exit;
    }
}

$finalFile = sys_get_temp_dir() . '/uploads/' . $fileId . '.final';
$fp = fopen($finalFile, 'wb');

for ($i = 0; $i < $totalChunks; $i++) {
    $chunkPath = $uploadDir . '/chunk_' . $i;
    $chunkData = file_get_contents($chunkPath);
    fwrite($fp, $chunkData);
    unlink($chunkPath); // 合并后立即删除分片
}
fclose($fp);

// 移动最终文件到持久化存储
$destination = '/var/www/uploads/' . basename($fileId);
mkdir(dirname($destination), 0777, true);
if (rename($finalFile, $destination)) {
    rmdir($uploadDir); // 清理空目录
    echo json_encode(['status' => 'merged', 'path' => $destination]);
} else {
    echo json_encode(['error' => 'Failed to move final file']);
}
?>

这段代码实现了完整的合并逻辑。它首先遍历预期的分片索引,确保每个分片文件都存在,这是保证文件完整性的关键步骤。接着,它打开一个写模式的文件指针,按顺序读取每个分片的内容并写入最终文件。每读取一个分片就立即删除,有助于控制磁盘占用。最后,使用`rename`原子操作将临时合并文件移动到生产环境目录,这不仅提高了效率,还避免了部分写入导致的文件损坏风险。整个过程严格依赖`file_id`进行隔离,确保多用户并发上传时不会发生冲突。

如果分片上传过程中断如何处理残留数据

在实际运行中,网络中断或客户端崩溃可能导致部分分片留在临时目录中,形成“孤儿”数据。为了解决这个问题,需要引入定期清理机制或手动清理接口。我们可以编写一个简单的脚本,扫描临时上传目录,查找那些超过一定时间(如24小时)未被合并的文件夹,并将其整个删除。此外,在合并接口中,如果发现某些分片缺失且无法补传,也应提供重置功能,允许前端重新发起上传,此时后端应清空该`file_id`对应的旧有分片数据,避免新旧数据混合。这种清理策略保证了服务器磁盘空间的可持续利用,防止因大量未完成上传任务导致的资源耗尽。

相关文章

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

php

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

创客贴AI

创客贴AI是一款AI图像与设计工具,AI辅助的智能在线设计工具。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

13424

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

7661

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2295

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

4848

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

5574

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

4391

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

6357

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

5022

2023.11.13

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

20

2026.11.20

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn