ThinkPHP多图上传需前端用name="images[]"或FormData多次append，后端用$request->file('images')接收数组；拖拽排序须传有序ID列表如sort_order，再映射更新数据库sort字段；务必校验$file非空、设enctype、调大max_file_uploads；保存与排序须用Db::transaction保证一致性。
ThinkPHP 多图上传怎么接收前端传来的多个 file 字段
ThinkPHP 默认把同名多文件当做一个数组处理，但前提是前端必须用标准的 name="images[]" 格式提交，而不是多个独立的 name="image1"、name="image2"。否则 $request->file() 只会拿到第一个。
实操建议：
- 前端确保
<input type="file" name="images[]" multiple>或通过 JS 构造FormData时用append('images', file)多次追加 - 后端用
$files = $request->file('images')接收，它会返回File对象数组（非空时），不是单个对象 - 如果前端用了自定义字段名如
upload_files，就别硬写images，得和实际一致 - 注意 Nginx/Apache 有默认单次请求最大上传数限制（如 PHP 的
max_file_uploads），上传超 20 个文件可能被截断，要同步调大
拖拽排序后的图片顺序怎么安全传给 ThinkPHP 后端
拖拽排序本身不产生新文件，只是改了顺序——关键在于前端必须把「排序后每张图的原始标识」按序传过来，比如 ID 或临时 token，不能只传文件再让后端猜顺序。
常见错误现象：用户拖完顺序，后端保存时还是按 $_FILES 原始接收顺序存，导致排序失效。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 前端在拖拽结束时生成一个有序 ID 数组，例如
['img_abc123', 'img_def456', 'img_ghi789']，作为额外字段sort_order提交 - 后端先保存所有上传文件，得到一组带唯一标识（如
md5(时间+随机)或数据库自增 ID）的新记录 - 再用前端传来的
sort_order和新记录 ID 做映射，更新每条记录的sort字段（整型） - 别用文件名当主键来关联顺序——重名、特殊字符、编码问题都会翻车
$request->file() 返回空或报错 Call to a member function move() on null
这个错误几乎都因为没校验 $request->file() 返回值是否为 null 或空数组，直接链式调用 move() 导致。
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
使用场景：用户没选文件、表单没设 enctype="multipart/form-data"、Nginx 代理时 body 被截断。
实操建议：
- 永远先判断：
if (!$files = $request->file('images')) { throw new ValidateException('请至少选择一张图片'); } - 检查 HTML 表单有没有
enctype="multipart/form-data"，漏了就全白搭 - 如果是 Ajax 上传，确认
FormData没漏掉append，且没重复set覆盖 - PHP 错误日志里搜
upload_max_filesize或post_max_size超限提示，这类配置错误不会抛异常，只会静默丢文件
保存多图与排序数据时事务怎么写才不丢关联
图片上传成功但排序字段没更新，或者排序写了但某张图上传失败——这两种情况都意味着数据不一致。必须用事务包住整个流程。
性能影响：事务会锁表，但图片上传本身是 IO 密集型，事务持续时间短，影响有限；反而比手动回滚更可靠。
实操建议：
- 用
Db::transaction()包裹：先批量插入图片记录（获取 ID 列表），再用sort_order映射更新各条的sort值 - 别在事务里做
move()操作——文件系统写入失败无法回滚，应先完成上传，再进事务处理数据库 - 如果用模型，确保
saveAll()返回的是完整对象数组，含自增 ID，方便后续绑定排序 - 事务内避免调用外部 HTTP 请求或长耗时逻辑，防止锁等待超时
最麻烦的其实是前端传来的 sort_order 和实际上传成功的图片数量对不上——这种情况得在事务前就校验并拒绝，不然事务里发现不匹配就只能干瞪眼。
