tp6.0多图上传需改用异步分片上传并逐片校验md5:前端须用name="images[0]"等显式编号,服务端禁用$request->file()改用$_files原生数组,逐片hash_file校验md5后落盘,最后合并并校验总md5。

TP6.0 多图上传时部分文件无声无息消失,不是前端没发全,也不是网络中断,而是框架对 multipart 数组解析失败或 validate() 后未及时 move() 导致临时文件被 PHP 清理——必须改用异步分片上传并逐片校验 MD5,才能确保每张图都落盘且内容完整。
确认前端发送标准分片结构
前端必须用 name="images[0]"、name="images[1]" 显式编号,不能用 name="images[]";浏览器扁平化后 TP6 无法识别为数组,$request->file('images') 将返回 null 或单个 File 实例。
使用 axios 发送时禁用自动设置 Content-Type,让浏览器生成带 boundary 的 multipart/form-data 头;手动构造 FormData 并 append 每片:formData.append('images[' + i + ']', file, file.name)。
【images[x] 中的 x 必须从 0 开始连续递增】,跳号(如 0、1、3)会导致 TP6 解析中断,后续索引全部错位。
服务端接收并初始化分片任务
第一步:获取上传总片数与唯一标识
$chunkCount = (int) $this->request->post('chunk_count', 0);
$uploadId = md5($this->request->post('file_name', '') . time() . uniqid());
第二步:创建分片缓存目录
$chunkDir = runtime_path() . 'upload_chunks/' . $uploadId . '/';
if (!is_dir($chunkDir) && !mkdir($chunkDir, 0755, true)) {
throw new Exception('无法创建分片缓存目录');
}
第三步:遍历 $_FILES 获取每片原始数据
不调用 $request->file('images') —— 它在低版本 TP6 中不支持数组解析;改用 $_FILES['images'] 原生数组,配合 foreach 循环提取每个 $_FILES['images']['tmp_name'][$i]。
逐片校验 MD5 并落盘
方法一:使用 PHP 原生 hash_file()
对每个分片临时文件调用 hash_file('md5', $_FILES['images']['tmp_name'][$i]),比对前端传来的 md5_list[$i];不一致则直接 unlink($_FILES['images']['tmp_name'][$i]) 并跳过保存。
方法二:流式校验防内存溢出
大分片(>5MB)禁用 hash_file(),改用 fopen + stream_copy_to_stream + hash_init('md5') 分块读取;否则可能触发 memory_limit 中断,导致该片静默丢失。
【校验通过前绝不调用 move_uploaded_file()】,否则临时文件被移动后无法再次读取计算 MD5。
合并完成文件并触发最终校验
① 按 chunk_index 升序读取所有已校验分片文件,用 file_get_contents() 拼接为完整二进制流;
② 对拼接后内容再次计算整体 MD5,与前端提交的 file_md5 总值比对;
③ 校验通过后,生成安全文件名:
$finalName = md5(uniqid() . $fileName) . '.' . pathinfo($fileName, PATHINFO_EXTENSION);
④ 写入目标路径:
file_put_contents(runtime_path() . 'uploads/' . date('Ym/d') . '/' . $finalName, $mergedContent);
⑤ 清理分片缓存目录:
array_map('unlink', glob($chunkDir . '*'));
rmdir($chunkDir);











