Laravel后端接收WebUploader分片需用$request->getContent()读取原始二进制流，校验chunk/chunks/fileId参数，按fileId/chunk_{n}存分片；合并前须校验各分片存在性及MD5一致性；断点续传状态应存Redis Set并提供GET /api/upload/chunks/{fileId}接口；nginx需配置client_max_body_size等参数支持大分片。
WebUploader 上传时后端如何接收分片
WebUploader 发送分片时，会把文件切片为多个 blob，每个请求携带固定参数：chunk（当前分片序号，从 0 开始）、chunks（总分片数）、fileId（唯一标识，如 md5 前缀）和 name（原始文件名）。Laravel 后端需用这些参数定位并保存对应分片。
关键点：不要依赖 $_FILES 或 $request->file() 的默认行为——WebUploader 默认用 multipart/form-data 提交，但分片是单个 blob，$request->file('file') 可能为 null，应改用 $request->getContent() 直接读取原始二进制流。
- 检查是否为分片请求：
if ($request->has(['chunk', 'chunks', 'fileId'])) - 用
$request->getContent()获取原始数据，避免 PHP 自动解析失败 - 分片存储路径建议按
fileId/chunk_{n}组织，例如：storage_path("app/uploads/chunks/{$fileId}/chunk_{$chunk}") - 务必校验
chunk和chunks是否为合法整数，防止路径遍历或整数溢出
Laravel 合并分片前如何校验完整性
合并不是简单地把所有分片按序 cat 到一起。漏传、重复传、内容损坏都会导致最终文件异常。必须在合并前做两层校验：分片存在性 + 内容一致性。
推荐做法是：每个分片上传成功后，立刻计算其 MD5（或 SHA256），存入缓存（如 Redis）或数据库，键为 "chunk_md5:{$fileId}:{$chunk}"；客户端也应在前端计算每片哈希并随请求带上 chunkMd5 字段。
- 合并前遍历
0到$chunks - 1，确认每个分片文件存在且大小非零 - 逐个读取已存分片，重新计算 MD5 并比对缓存值，不一致则中断合并并返回错误
- 可选：对整个拼接后的临时文件再算一次整体 MD5，与客户端传来的
fileMd5比对（需前端支持） - 避免在合并过程中长时间锁表或阻塞请求，建议用队列（
php artisan queue:work）异步处理
如何用 Laravel 实现断点续传状态查询接口
WebUploader 调用 getUploadedChunks 时，会向后端发起 GET 请求，期望返回已上传成功的分片索引数组（如 [0,1,3,4]）。这个接口必须轻量、无副作用、高并发安全。
不能每次查磁盘是否存在文件——IO 开销大且不一致。最佳实践是：上传分片成功后，立即将该 chunk 索引写入 Redis 的 Set 结构，例如：redis->sAdd("uploaded_chunks:{$fileId}", $chunk)；查询接口直接 smembers 即可。
- 接口路由建议定义为：
GET /api/upload/chunks/{fileId} - 响应格式严格为 JSON 数组：
[0,1,2,4]
，不要包裹在{"data": [...]}中，否则 WebUploader 解析失败 - 注意 Redis key 过期策略，可用
EXPIRE设置 24 小时，避免碎片堆积 - 如果业务要求长期保留上传状态，可降级为查数据库，但必须给
(file_id, chunk)加联合索引
nginx 配置对大文件分片上传的关键影响
即使 Laravel 逻辑完全正确，nginx 默认配置也会拦截大分片请求——常见报错是 413 Request Entity Too Large 或连接被重置。这不是 PHP 的 upload_max_filesize 能解决的。
必须在 nginx 的 server 或 location 块中显式调大两个参数，并确保它们作用于上传接口路径：
-
client_max_body_size 1024m：允许单次请求体最大 1GB（根据业务调整） -
client_body_buffer_size 128k：缓冲区太小会导致频繁写临时文件，影响性能 - 若使用 HTTPS，还需确认
ssl_buffer_size不过小（默认 4k 通常够用） - 禁用
client_body_timeout或设为较大值（如300s），防止慢速上传被中断
改完记得 nginx -t && nginx -s reload，且要验证生效——可在上传接口里打印 $_SERVER['CONTENT_LENGTH'] 看是否能收到预期大小的请求体。
最常被忽略的是：开发环境用 Valet / Homestead / Sail 时，这些代理层可能自带 nginx 配置，覆盖了你的修改。务必确认最终生效的是你改的那一份。
