Laravel 8如何实现多图片上传？所写代码运行报错求解

原代码常见报错原因 #

• 前端表单配置错误：如果表单标签未加enctype="multipart/form-data"属性，或者文件输入框未设置name="files[]"数组格式、未加multiple属性，后端无法正确获取多文件集合，$request->file('files')会返回null或单个文件实例，直接遍历会抛出错误。
• 缺少参数校验：原代码未验证上传参数的合法性，当未传文件、或传入的是单个文件而非数组时，$files不是可遍历的集合，foreach执行时直接报错。
• 模型批量赋值限制：如果ProductGallery模型未配置$fillable属性开放products_id、url字段的批量赋值权限，调用create()方法时会抛出批量赋值异常。
• 存储配置不规范：store()方法默认使用local磁盘，原代码未明确指定public磁盘，且存储到数据库的路径未做软链适配，后续前端访问文件时会出现404错误。

正确实现步骤 #

• 配置前端表单
  确保表单包含必填的上传属性，文件输入框设置为支持多文件的数组格式：

  <form method="POST" action="/product/gallery/upload" enctype="multipart/form-data">
      @csrf
      <input type="file" name="files[]" multiple accept="image/*">
      <button type="submit">上传图片</button>
  </form>
  

• 生成存储软链
  执行Artisan命令创建public目录到存储目录的软链，保证上传的文件可以通过web路径正常访问：

  php artisan storage:link
  

• 配置模型批量赋值权限
  打开app/Models/ProductGallery.php文件，配置允许批量写入的字段：

  <?php
  
  namespace App\Models;
  
  use Illuminate\Database\Eloquent\Model;
  
  class ProductGallery extends Model
  {
      protected $fillable = [
          'products_id',
          'url'
      ];
  }
  

• 编写后端上传逻辑
  先校验上传参数的合法性，再循环处理每个文件，存储时明确指定public磁盘，生成可直接访问的文件路径存入数据库。

修正后的可运行代码 #

// 校验上传参数，限制文件类型和大小
$request->validate([
    'files' => 'required|array',
    'files.*' => 'image|max:2048' // 单张图片最大2MB，可根据业务需求调整
]);

$files = $request->file('files');
foreach ($files as $file) {
    // 将文件存储到public磁盘的gallery目录，自动生成唯一文件名
    $storagePath = $file->store('gallery', 'public');
    // 拼接前端可直接访问的路径
    $accessUrl = 'storage/' . $storagePath;

    ProductGallery::create([
        'products_id' => $product->id,
        'url' => $accessUrl
    ]);
}

注意：如果是单文件上传场景，$request->file('files')会返回单个UploadedFile实例，无法直接遍历，必须保证前端文件字段加[]后缀、配置multiple属性，后端才能识别为多文件数组。

内容的提问来源于stack exchange，提问作者Muhammad Yusril Amin