如何在ThinkPHP中处理大文件断点续传_前端切片与后端合并文件验证逻辑-ThinkPHP-PHP中文网

ThinkPHP分片上传需显式获取chunk参数，存入安全路径并校验索引与大小；合并前须双重验证分片完整性，流式写入防内存溢出；合并后通过文件MD5去重，并在事务中清理分片。

如何在thinkphp中处理大文件断点续传_前端切片与后端合并文件验证逻辑

分片上传不是直接把整个文件扔给服务器，而是前端按固定大小切出多个 chunk，每个带编号和唯一标识（如 file_id 或 md5），后端要能独立接收、存临时目录、不覆盖、不混片。

必须用 $_FILES 之外的方式接收：ThinkPHP 的 request()->file() 对单次上传友好，但分片常走 POST 表单或 multipart/form-data 中的普通字段传 chunk 内容，建议用 input('chunk') + input('chunk_index') + input('file_id') 显式取值
临时存储路径别硬写 ./runtime/chunk/，用 Env::get('root_path') . 'public/upload/chunk/' 更稳妥，避免 runtime 被清空导致断点失效
文件名必须包含 file_id 和 chunk_index，例如 {$file_id}_{$chunk_index}.part，否则多个用户同时传同名文件会互相覆盖
务必校验 chunk_index 是数字、chunk_index >= 0，防止恶意请求写任意路径（如 ../../../etc/passwd）

不能一收到最后一个分片就合并——网络抖动可能让某个中间分片延迟到达，或前端误报总片数。必须主动检查“该 file_id 下应有 N 片，实际落盘 M 片”，且每片大小符合预期（最后一片可略小，其余必须严格等于切片大小）。

用 glob(Env::get('root_path') . 'public/upload/chunk/' . $file_id . '_*.part') 列出全部分片文件，再用 count() 比对 total_chunks
逐个 filesize() 校验：除最后一片外，其余必须等于前端传来的 chunk_size（比如 5242880 字节），否则是传输损坏
别依赖前端传的 total_chunks 值做唯一判断——它可能被篡改，应以实际文件数量 + 文件大小双重验证为准
建议加个超时清理：查到某 file_id 的分片 2 小时内没收齐，就删掉已有分片，避免磁盘被碎片占满

用 file_get_contents() 读所有分片再 file_put_contents() 写入，1GB 文件就可能爆内存；用 fopen() + fwrite() 流式合并更安全，但要注意文件锁和追加顺序。

绝对不要用 file_get_contents($chunk) 把整个分片读进内存——哪怕只有 5MB，100 片就是 500MB
正确做法：用 fopen($target_file, 'wb') 创建目标文件，然后对每个分片按 chunk_index 升序 fopen($chunk, 'rb') → fread() 分块（如每次 8192 字节）→ fwrite() 追加
合并过程中若出错（如某分片被删），要立刻 unlink($target_file)，否则留下不完整文件干扰后续逻辑
PHP 的 max_execution_time 默认 30 秒，大文件合并很容易超时，应在合并前加 set_time_limit(0)，但必须配超时兜底（比如记录开始时间，每处理一片检查是否超 10 分钟）

前端可能因网络重试多次触发“上传完成”请求，后端若没幂等控制，就会生成多个相同文件，甚至覆盖原文件。

核心是用文件内容指纹（如全量 md5_file()）做最终校验，而不是靠 file_id 或文件名
合并完成后立即计算 md5_file($target_file)，查数据库看该 md5 是否已存在；存在则删新文件，返回已有文件 URL
注意：md5_file() 对 2GB+ 文件很慢，可先用分片 md5 拼接成“分片指纹”快速初筛，再对通过初筛的做全量校验
数据库里存 md5、original_name、size、upload_time 四个字段就够了，别存路径——路径可能随部署变，而 md5 是唯一锚点