Nova Media Library 使用教程

Nova Media Library 使用教程

1、项目介绍

Nova Media Library 是一个为 Laravel Nova 管理面板设计的媒体库扩展包。它允许用户在 Nova 管理面板中管理媒体文件，支持多种媒体类型，如图片、视频等。该扩展包基于 Spatie 的 Media Library 包，提供了更高级的功能，如多图上传、拖拽排序、图片裁剪等。

2、项目快速启动

安装

首先，确保你已经安装了 Laravel Nova 和 Spatie Media Library。然后，通过 Composer 安装 Nova Media Library：

composer require classic-o/nova-media-library

发布配置文件

安装完成后，发布配置文件：

php artisan vendor:publish --tag=nova-media-library

配置模型

在你的模型中配置媒体库，例如：

use Spatie\MediaLibrary\MediaCollections\Models\Media;

public function registerMediaConversions(Media $media = null): void
{
    $this->addMediaConversion('thumb')
        ->width(130)
        ->height(130);
}

public function registerMediaCollections(): void
{
    $this->addMediaCollection('main')->singleFile();
    $this->addMediaCollection('my_multi_collection');
}

使用 Nova 字段

在你的 Nova 资源中使用 Media Library 字段：

use ClassicO\NovaMediaLibrary\MediaLibrary;

public function fields(Request $request)
{
    return [
        MediaLibrary::make('Media'),
    ];
}

3、应用案例和最佳实践

应用案例

Nova Media Library 可以用于各种需要管理媒体文件的应用场景，例如：

• 电子商务平台：管理产品图片和视频。
• 博客系统：管理文章中的图片和视频。
• 社交媒体平台：管理用户上传的图片和视频。

最佳实践

• 图片优化：使用 registerMediaConversions 方法生成不同尺寸的图片，以优化加载速度。
• 多图管理：使用 addMediaCollection 方法管理多图集合，并通过拖拽排序功能提升用户体验。
• 安全性：确保上传的文件类型和大小符合要求，避免安全风险。

4、典型生态项目

Nova Media Library 通常与其他 Laravel 生态项目一起使用，例如：

• Laravel Nova：管理面板框架，Nova Media Library 是其扩展包。
• Spatie Media Library：媒体库管理包，Nova Media Library 基于此包。
• Intervention Image：图片处理库，用于图片裁剪和优化。

通过这些项目的结合使用，可以构建功能强大且易于管理的媒体库系统。