Laravel多图上传需前端name设为images[]，后端用request()->file('images')获取数组并遍历，校验非空后用storeAs()指定路径与唯一文件名，再批量insert到关联模型表；读取时按磁盘类型选URL::to()或Storage::url()。
如何用 request()->file() 正确接收多图上传
Laravel 默认支持多文件上传，但必须确保前端 <input> 的 name 属性带方括号（如 images[]），否则 request()->file('images') 只会返回单个文件或 null。
后端接收时不要用 request()->file('images')->store() —— 这是单文件方法，对数组会报 Call to a member function store() on array 错误。
- 正确写法：用
request()->file('images')得到array，再遍历每个UploadedFile实例 - 务必先校验是否为有效数组：
is_array($files) && !empty($files) - 注意：如果表单没选任何文件，
request()->file('images')返回空数组，不是null
怎么用 storeAs() 控制上传路径与文件名
直接用 store() 会生成随机哈希名并存入默认磁盘根目录，不利于后续关联查询和 CDN 缓存。更可控的做法是显式调用 storeAs()，自己拼路径和文件名。
常见陷阱：路径开头加 / 会导致 Laravel 写入失败（底层用的是 Flysystem，路径是相对磁盘根的）；文件名含中文或空格可能在某些服务器出问题。
HISUI 前端框架基础开发指南。HISUI 是基于 easyui 二次开发的 jQuery UI 组件库，专为医疗信息系统设计。当涉及 HISUI 组件开发、jQuery easyui 表格/表单/布局/窗口、医疗系统前端页面编写时使用此 skill。 涵盖 40 个组件的官方文档参考，支持声明式与编程式两种初始化方式，提供 $cm/$m 数据访问方法。
- 推荐生成唯一但可读的文件名：比如
md5($file->getClientOriginalName() . time()) . '.' . $file->extension() - 目录建议按日期分层，例如
'uploads/images/' . now()->format('Y/m/d') - 完整调用示例：
$path = $file->storeAs('uploads/images/' . now()->format('Y/m/d'), $filename, ['disk' => 'public'])
如何把多张图和模型做一对多关联（不用 attach()）
多数人第一反应是用 Eloquent 多对多 + 中间表，但图片通常是“属于某条记录”的一对多关系（如一篇商品有多个轮播图），应建独立图片表，外键指向主模型 ID。
别在控制器里手动写 DB::table()->insert() —— 丢失模型事件、类型转换和批量插入优化。要用模型实例批量创建。
- 假设已有
Product模型和对应的ProductImage模型，后者含product_id、path、order字段 - 上传成功后，用
ProductImage::insert($data)批量写入（$data 是二维数组），比循环save()快得多 - 注意：
insert()不触发creating/created事件，如需处理缩略图或水印，得在插入前用循环+new ProductImage()方式
前端预览多图时，URL::to() 和 Storage::url() 别混用
如果图片存在 public 磁盘，用 URL::to('storage/xxx.jpg')；如果存在 local 或 s3 磁盘且已配置 url 可见性，则必须用 Storage::url('xxx.jpg')，否则生成的链接 404。
常见错误：上传时用了 storeAs(..., 'public')，但读取时却调用 Storage::url() —— 因为 public 磁盘不走 Storage URL 生成逻辑，它只是符号链接到 public/storage。
- 检查磁盘配置：
config/filesystems.php中public磁盘的'driver' => 'local'，而'url'是静态前缀 - 统一做法：上传后保存的是相对路径（如
uploads/images/2024/06/15/abc.jpg），读取时根据磁盘类型决定调用方式 - 安全提醒：不要把用户上传的原始文件名直接拼进 URL，避免路径遍历，
basename($path)是必要过滤
foreach (request()->file('images') as $file) {
$filename = md5($file->getClientOriginalName() . time()) . '.' . $file->extension();
$path = $file->storeAs('uploads/images/' . now()->format('Y/m/d'), $filename, ['disk' => 'public']);
$images[] = [
'product_id' => $product->id,
'path' => $path,
'order' => $loop->index,
];
}
ProductImage::insert($images);
Laravel 多图上传真正的复杂点不在上传本身，而在路径管理、URL 构造和数据库一致性之间保持同步——尤其是当磁盘切换（本地→S3）、路径规则变更或需要支持删除重传时，硬编码路径或混用 URL 生成方式会立刻暴露问题。 
