关键在前端：name="images[]"且含multiple属性，laravel才返回文件数组；数据库应拆分为一对多关系；验证须用'images.*'规则；存储只存相对路径，读取用storage::url()。
如何让 request->file('images') 正确返回数组
关键不在后端逻辑，而在前端表单的 name 和 multiple 属性。如果 name="images"（没加 []），Laravel 默认只取第一个文件，request->file('images') 返回单个 UploadedFile 实例；只有设为 name="images[]"，它才返回 UploadedFile[] 数组。
常见错误现象：
- 明明选了 5 张图，后端
count($request->file('images'))却是 1 -
foreach报错 “Invalid argument supplied for foreach()”
必须确保：
- HTML input 标签含
multiple属性 -
enctype="multipart/form-data"存在且正确 -
name值以[]结尾，如name="images[]"
store() 路径和数据库字段怎么对齐
多图上传不是把所有路径拼成一个字符串存进单字段就完事——这会导致后续查单张图、删某张图、改顺序等操作全部变困难。推荐拆成一对多关系：一个主记录（如 albums 表） + 多条子记录（album_photos 表）。
实操建议：
- 主表（如
Album）只存业务元信息：user_id、content、created_at - 子表（如
AlbumPhoto）每行存一张图：album_id、path、order、original_name - 用
$album->photos()->createMany($photoData)批量插入，比循环create()更高效
别省事写 $photos_url = implode(',', $paths) —— 后期加水印、按宽高筛选、分页查图都会卡住。
验证规则必须用 images.* 而不是 images
request->validate() 对数组字段的验证语法有严格要求。写 'images' => 'required|array' 只校验“有没有这个字段”，不校验每个文件；真正控制单个文件行为的，是带 .* 的嵌套规则。
典型配置：
request->validate([
'images.*' => 'required|image|mimes:jpg,jpeg,png,gif|max:2048',
'content' => 'nullable|string|max:500'
]);
注意点：
-
images.*会自动遍历数组每一项，分别执行image和max:2048校验 - 如果漏掉
.*，上传超限图片时不会报错，但store()会静默失败或抛出FileException - 前端若传空数组（比如用户取消选择），
images.*不会触发，需额外加'images' => 'required|array|min:1'
别忽略 Storage::url() 和磁盘驱动的耦合
调用 $file->store('images', 'public') 得到的是相对路径（如 images/abc.png），但直接存库不能直接用这个值——它依赖当前 FILESYSTEM_DRIVER 配置。一旦你从 public 切到 s3，所有硬编码的 /storage/ 前缀就失效。
安全做法：
- 数据库里只存相对路径（如
images/abc.png），不存完整 URL - 读取时统一用
Storage::url($path)生成可访问链接 - 确保
php artisan storage:link已执行（本地开发时）
最容易被忽略的地方：Postman 测试时如果用 form-data 传多个同名 key（如两个 images 字段），Laravel 会只取最后一个——必须用单个 key + multiple + name="images[]" 才能拿到数组。
