README

一组带有 Flysystem 适配器的 Laravel Nova 字段，用于存储和检索来自 Cloudinary 的媒体。

此包将使您能够使用Cloudinary服务来处理您的 Nova 文件上传。

安装

使用 composer 安装此包

composer require silvanite/nova-field-cloudinary

将 cloudinary 磁盘添加到文件系统配置中，并设置您的 Cloudinary 账户的环境变量。

// config/filesystem.php
return [
    ...
    'disks' => [
        ...
        'cloudinary' => [
            'driver' => 'cloudinary',
            'api_key' => env('CLOUDINARY_API_KEY'),
            'api_secret' => env('CLOUDINARY_API_SECRET'),
            'cloud_name' => env('CLOUDINARY_CLOUD_NAME'),
        ]
    ]
];

使用 CloudinaryImage 字段

只需在您的资源的字段中使用 CloudinaryImage 字段代替标准的 Nova Image 字段。此组件扩展了默认的 Image 字段，因此您可以使用与标准字段相同的所有选项。

use Silvanite\NovaFieldCloudinary\Fields\CloudinaryImage;

public function fields(Request $request)
{
    return [
        ...
        CloudinaryImage::make('Profile Photo'),
    ]
}

这将与 Image::make()->disk('cloudinary') 做同样的事情，但它还会在 Nova UI 中本身提供调整大小和优化过的预览和缩略图图像。但是，如果您不想这样做，您也可以只使用标准的 Image 字段。

要使用应用程序中的图像，您可以使用 cloudinary_image 助手或使用 Storage 门面读取图像。

// Using the helper (with transformation)

return cloudinary_image($this->profile_photo, [
    "width" => 200,
    "height" => 200,
    "crop" => "fill",
    "gravity" => "auto",
])

// Using the Storage Facade (without transformation)

return Storage::disk('cloudinary')->url($this->profile_photo);

// Using the Storage Facade (with transformation)

return Storage::disk('cloudinary')->url([
    'public_id' => $this->profile_photo,
    'options' => [
        "width" => 200,
        "height" => 200,
        "crop" => "fill",
        "gravity" => "auto",
    ],
])

最大文件大小

Cloudinary 根据您的账户计划对图像施加最大文件大小限制。截至编写时，免费计划允许图像大小最高为 10mb。

如果成功上传的图像通过 Cloudinary 转换并放大超过此文件大小，则该图像的下载将在前端失败，返回 400 错误。

这种情况特别可能发生在处理动画 GIF 图像时，这些图像通常是较小分辨率的较大文件，容易在图像处理器中进行放大。

使用 CloudinaryAudio 字段

只需在您的资源的字段中使用 CloudinaryAudio 字段。此组件扩展了 davidpiesse/nova-audio，而 davidpiesse/nova-audio 又扩展了默认的 Nova 文件字段，因此您可以使用与标准字段相同的所有选项。

use Silvanite\NovaFieldCloudinary\Fields\CloudinaryAudio;

public function fields(Request $request)
{
    return [
        ...
        CloudinaryAudio::make('Audio Source'),
    ]
}

此字段将使用的磁盘设置为 Cloudinary，并确保媒体存储在数据库字段中，具有正确的文件扩展名。此外，字段将预览 URL 设置为使用 Cloudinary 中的适当路径，以便在 CMS 中播放音频。

要使用应用程序中的音频文件，您可以使用 cloudinary_audio() 助手或使用 Storage 门面读取音频文件。注意，Cloudinary 一起存储图像和视频，因此如果使用 Storage 门面，则选项数组中的 resource_type 应设置为 video。

// Using the audio helper

return cloudinary_audio($this->audio_source);

// Using the Storage Facade

return Storage::disk('cloudinary')->url([
    'public_id' => $this->audio_source,
    'options' => [
        "resource_type" => "video",
    ],
])