在现代 Web 应用中，视频内容无处不在。无论是产品演示、在线课程还是用户生成内容，视频都扮演着越来越重要的角色。对于我们这些使用 Laravel Nova 构建后台管理面板的开发者来说，如何高效、优雅地处理视频文件，一直是一个不小的挑战。

想象一下，你的项目需要一个功能，允许管理员上传视频到文章或产品详情页。最初，你可能会尝试使用 Nova 自带的 File 字段。它确实能让你上传文件，但当涉及到视频时，问题就来了：

1. 缺乏直观的播放体验：上传后，你只能看到一个文件链接，无法直接在 Nova 面板内预览或播放视频。管理员需要下载文件才能查看，这大大降低了效率。
2. 管理不便：删除、替换视频都需要额外的逻辑处理，且没有专门的 UI 提示。
3. 高级功能缺失：如果需要为视频添加封面（海报）、提取视频时长、分辨率等元数据，或者更进一步实现视频转码、HLS 流媒体，那么 File 字段就完全无能为力了，你不得不从头开始构建复杂的解决方案。

这些问题不仅增加了开发成本，也极大地影响了管理员的使用体验。难道就没有一个更简单、更集成的方式来解决这些痛点吗？

答案是肯定的！今天我要向大家隆重推荐一个 Composer 包——mostafaznv/nova-video。

mostafaznv/nova-video：Nova 视频管理专家

mostafaznv/nova-video 是一个专门为 Laravel Nova 设计的视频字段，它扩展了 Nova 内置的文件字段，旨在简化本地视频文件的上传和在 Nova 面板中的显示过程。最棒的是，它的基础功能无需任何额外依赖，开箱即用！

安装过程非常简单，只需一条 Composer 命令：

composer require mostafaznv/nova-video

安装完成后，你就可以在你的 Nova Resource 中像使用其他字段一样使用 NovaVideo 字段了。

基本用法示例：

// app/Nova/Post.php
namespace App\Nova;

use Laravel\Nova\Fields\ID;
use Illuminate\Http\Request;
use Mostafaznv\NovaVideo\NovaVideo; // 别忘了引入这个字段

class Post extends Resource
{
    // ... 其他属性和方法

    public function fields(Request $request)
    {
        return [
            ID::make()->sortable(),

            NovaVideo::make('视频', 'video_path') // 第一个参数是标签，第二个是数据库字段名
                ->disk('public') // 指定存储视频的磁盘
                ->path('posts/videos') // 指定在磁盘上的存储路径
                ->rules('mimes:mp4,mov,ogg,qt', 'max:102400') // 添加验证规则，例如文件类型和大小
                ->displayAsLink() // 可选：在索引页显示为链接而不是播放器
                ->prunable(), // 可选：当模型被删除时，自动删除关联的视频文件

            // ... 其他字段
        ];
    }
}

通过上述配置，你的 Nova 面板将立即获得以下基础功能：

• 视频上传：管理员可以直接上传视频文件。
• 视频播放：在详情页，视频将通过 HTML5 或 Vidstack 播放器直接播放，无需下载。
• 视频删除：提供删除已上传视频的选项。
• 视频替换（更新）：轻松替换现有视频。
• 视频下载：提供下载视频的链接。
• 本地化支持：字段标签和提示信息支持多语言。
• 高度可配置：你可以自定义存储磁盘、路径、验证规则等。

结合 Larupload，解锁高级视频能力

如果你的项目对视频处理有更高的要求，例如需要自动生成视频海报、提取视频元数据（时长、宽高、主色调），甚至实现视频的裁剪、缩放或 HTTP Live Streaming (HLS) |直播|流，那么 mostafaznv/nova-video 还能与另一个强大的包 Larupload 完美结合，提供额外的进阶功能：

• 视频海报：自动为视频生成预览海报。
• 元数据提取：自动获取视频的时长、宽度、高度和主色调。
• 视频/图片处理：支持对视频和图片进行尺寸调整或裁剪。
• HLS 流媒体：从视频源创建 HTTP Live Streaming (HLS)，优化播放体验和带宽。

要启用这些高级功能，你需要额外安装 Larupload 并进行相应配置。在 NovaVideo 字段中，通常会有一个方法（如 ->withLarupload() 或类似配置）来激活与 Larupload 的集成。

总结与应用效果

mostafaznv/nova-video 彻底解决了在 Laravel Nova 中管理视频的痛点。它的优势显而易见：

• 开发效率提升：无需编写复杂的自定义逻辑，几行代码即可实现完整的视频上传和播放功能。
• 用户体验优化：管理员可以直接在 Nova 面板中预览、播放和管理视频，操作更加直观便捷。
• 功能强大且可扩展：基础功能满足日常需求，结合 Larupload 后更能应对各种复杂的视频处理场景。
• 代码整洁可维护：将视频管理逻辑封装在字段中，使你的 Nova Resource 保持简洁。

无论你是构建一个在线教育平台、一个媒体内容管理系统，还是任何需要视频上传和展示功能的 Laravel Nova 应用，mostafaznv/nova-video 都是一个值得你尝试的强大工具。它将帮助你轻松驾驭视频内容，让你的后台管理系统更加专业和高效。