laravel怎么使用Spatie的medialibrary包管理文件和图片_laravel Spatie medialibrary文件和图片管理教程-Laravel-PHP中文网

laravel怎么使用Spatie的medialibrary包管理文件和图片_laravel Spatie medialibrary文件和图片管理教程

裘德小鎮的故事

发布： 2025-10-31 01:55:35

原创

769人浏览过

Spatie medialibrary 可方便管理 Laravel 模型的文件和图片，支持上传、缩略图生成、多磁盘存储等。1. 安装包并发布迁移与配置文件；2. 模型使用 InteractsWithMedia trait 并定义媒体集合；3. 控制器中通过 addMedia 上传文件或从 URL 添加；4. 模板用 getFirstMediaUrl 或 getMedia 获取图片链接；5. registerMediaConversions 定义图像变体如 thumb；6. 调用 delete 或 clearMediaCollection 删除文件；7. 配置 filesystems.php 磁盘并创建 storage:link 软链接以公开访问。

laravel怎么使用spatie的medialibrary包管理文件和图片_laravel spatie medialibrary文件和图片管理教程

在 Laravel 中使用 Spatie 的 medialibrary 包可以非常方便地管理模型关联的文件和图片，比如用户头像、商品图片、文章附件等。它支持上传、生成缩略图、自定义路径、多磁盘存储等功能，是 Laravel 生态中最受欢迎的媒体管理工具之一。

1. 安装 Spatie medialibrary

在 Laravel 项目根目录下运行以下命令安装包：

composer require spatie/laravel-medialibrary

登录后复制

发布迁移文件并执行数据库更新：

php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="migrations"

登录后复制

php artisan migrate

登录后复制

发布配置文件（可选）：

php artisan vendor:publish --provider="Spatie\MediaLibrary\MediaLibraryServiceProvider" --tag="config"

登录后复制

配置文件位于 config/media-library.php，可根据需要修改默认磁盘、命名规则等。

2. 模型设置：添加媒体支持

假设你要为 Product 模型添加图片管理功能。

确保模型使用了 InteractsWithMedia trait，并注册媒体集合：

<?php
<p>namespace App\Models;</p><p>use Illuminate\Database\Eloquent\Model;
use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;</p><p>class Product extends Model implements HasMedia
{
use InteractsWithMedia;</p><pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">// 可选：定义特定集合
public function registerMediaCollections(): void
{
    $this->addMediaCollection('images')
         ->useDisk('public'); // 使用 public 磁盘

    $this->addMediaCollection('downloads')
         ->useDisk('local');
}

登录后复制

}

上面代码中：

HasMedia 是接口
InteractsWithMedia 提供具体方法
registerMediaCollections() 用于定义不同用途的媒体集合
useDisk() 指定存储磁盘（需在 filesystems.php 配置）

3. 上传文件或图片

在控制器中处理上传请求：

use Illuminate\Http\Request;
use App\Models\Product;
<p>public function store(Request $request)
{
$product = Product::create(['name' => $request->name]);</p><pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">if ($request->hasFile('photo')) {
    $product->addMedia($request->file('photo'))
            ->toMediaCollection('images');
}

return redirect()->back();

登录后复制

}

你也可以上传多个文件：

if ($request->hasFile('photos')) {
    foreach ($request->file('photos') as $photo) {
        $product->addMedia($photo)->toMediaCollection('images');
    }
}

登录后复制

或者从 URL 添加图片：

$product->addMediaFromUrl('https://example.com/photo.jpg')
         ->toMediaCollection('images');

登录后复制

4. 显示图片或文件链接

获取第一个图片：

改图鸭AI图片生成

查看详情

<img src="{{ $product->getFirstMediaUrl('images') }}" alt="Product">

登录后复制

获取所有图片：

@foreach($product->getMedia('images') as $media)
    <img src="{{ $media->getUrl() }}" width="200" alt="">
    <!-- 缩略图：$media->getUrl('thumb') -->
@endforeach

登录后复制

获取文件下载链接：

<a href="{{ $product->getFirstMediaUrl('downloads') }}" target="_blank">下载文件</a>

登录后复制

5. 生成图片缩略图

medialibrary 支持自动生成图像变体（如缩略图）。

在模型中定义：

public function registerMediaConversions($media = null): void
{
    $this->addMediaConversion('thumb')
          ->width(100)
          ->height(100)
          ->sharpen(10);
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">$this->addMediaConversion('web')
      ->width(800)
      ->height(600)
      ->optimize()
      ->format('webp');

登录后复制

}

模板中使用：

<img src="{{ $media->getUrl('thumb') }}">
<img src="{{ $media->getUrl('web') }}">

登录后复制

注意：只有图像类型才会生成这些变体。

6. 删除和清理文件

删除某个媒体文件：

// 删除指定媒体
$media = $product->getMedia('images')->first();
$media->delete();
<p>// 或者清空整个集合
$product->clearMediaCollection('images');</p><p>// 清空并重新上传
$product->clearMediaCollection('images');
$product->addMedia($newFile)->toMediaCollection('images');

登录后复制

软删除模型时自动清理媒体（需配置）：

protected static function booted()
{
    static::deleted(function ($product) {
        $product->media->each->delete();
    });
}

登录后复制

7. 配置文件系统（filesystems）

确保 config/filesystems.php 中有合适的磁盘配置，例如：

'disks' => [
    'public' => [
        'driver' => 'local',
        'root' => storage_path('app/public'),
        'url' => env('APP_URL').'/storage',
        'visibility' => 'public',
    ],
<pre class="brush:php;toolbar:false;"><pre class="brush:php;toolbar:false;">'local' => [
    'driver' => 'local',
    'root' => storage_path('app'),
],

登录后复制

]

运行以下命令创建软链接，使存储文件可通过 Web 访问：