TP6无法实现单请求内多文件并发上传，需前端并发发起多个独立POST请求，后端用request->file('files.*')获取数组并遍历moveTo()，配合唯一文件名生成与PHP/Nginx配置调优。
ThinkPHP 本身不内置多文件异步上传或并发上传能力，所谓“异步”实际依赖前端（如 Axios、Fetch、Web Workers）分片/并行提交，后端仍是同步接收每个请求；TP6 的 request->file() 和 moveTo() 是阻塞式 IO，无法在单个请求中“并发处理多个文件”。真要提升上传吞吐，得从请求层拆分 + 后端轻量处理入手。
怎么用 TP6 接收前端并发发来的多个文件请求
前端同时发起 N 个独立的 POST 请求（每请求带 1 个文件），TP6 每个请求走正常流程即可。关键不是“一个接口传多个”，而是“多个接口同时传”：
-
request->file('upload')只能取当前请求的单个文件字段（即使前端传了同名数组，TP6 默认不自动转为数组，需显式用request->file('upload.*')） - 若前端用
FormData.append('files[]', file)，后端要用request->file('files.*')获取文件对象数组，再遍历moveTo() - TP6 不限制单次请求的文件数量，但 PHP 配置
max_file_uploads和post_max_size会生效，超限直接报 400 或空数组 - 每个请求独立执行，无共享状态，天然支持“并发”——只要 Web 服务器（Nginx/Apache）和 PHP-FPM 进程数够用
为什么不能在 TP6 里用协程做文件上传并发
TP6 官方未适配 Swoole 协程文件上传（Swoole\Http\Server 的 onRequest 中，$_FILES 不可用，需手动解析 raw body）。即使强行用 Swoole\Coroutine\HTTP\Client 在服务端发起反向上传请求，也毫无意义——既增加延迟，又浪费资源：
- PHP 原生
move_uploaded_file()是同步系统调用，协程无法让它变非阻塞 - TP6 的
UploadFile类内部没做协程兼容，直接 await 会报错或行为异常 - 真正需要协程的场景是“上传后触发大量 IO 操作（如压缩、转码、写 DB）”，而非上传本身
如何避免多文件上传时的命名冲突和覆盖
前端并发上传时，如果都用原始文件名（如 avatar.jpg），后端不做处理极易覆盖。TP6 的 moveTo() 第二个参数是目标路径+文件名，必须自己生成唯一名：
立即学习“PHP免费学习笔记（深入）”；
- 别用
md5_file($tmpFile)—— 文件还没移动，临时文件可能被清理，读不到内容 - 推荐组合：时间戳 + 微秒 + 随机字符串 + 原扩展名，例如
sprintf('%s_%s.%s', date('YmdHis'), uniqid(), $file->extension()) - 如果存 OSS/S3，可直接用 UUID 作 key，无需关心本地重命名
- 注意
$file->validate(['size'=>1024*1024*2, 'ext'=>'jpg,png,gif'])要在moveTo()前调用，否则验证的是临时文件路径
真正卡点不在 TP6 怎么写，而在前端如何控制并发数（避免打爆 PHP-FPM）、Nginx 是否配置了 client_max_body_size、以及上传完成后的状态聚合（比如 10 个文件传完才触发后续逻辑）——这部分得靠 Redis 计数或数据库标记，TP6 自己不提供上传队列机制。
