README

Laravel Cloudinary文件系统驱动程序。

要求

• Laravel
• Cloudinary账户详细信息

Laravel版本兼容性

安装

通过命令使用composer安装此包

composer require yoelpc4/laravel-cloudinary

环境变量

在此处注册您的Cloudinary账户详细信息here。然后添加以下行到您的.env文件。

FILESYSTEM_DISK=cloudinary

CLOUDINARY_API_KEY=
CLOUDINARY_API_SECRET=
CLOUDINARY_CLOUD_NAME=
CLOUDINARY_SECURE=true

文件系统配置

在config/filesystems.php的disks部分注册cloudinary驱动程序配置，如下所示

'cloudinary' => [
    'driver'         => 'cloudinary',
    'api_key'        => env('CLOUDINARY_API_KEY'),
    'api_secret'     => env('CLOUDINARY_API_SECRET'),
    'cloud_name'     => env('CLOUDINARY_CLOUD_NAME'),
    'secure'         => env('CLOUDINARY_SECURE', true),
    'resource_types' => [
        'image' => [
            'png',
            'jpeg',
            'jpg',
        ],
        'video' => [
            'mp4',
            'avi',
            'mp3',
            'flac',
        ],
        'raw'   => [
            'pdf',
            'xlsx',
            'csv',
            'txt',
        ],
    ],
],

当从存储生成URL时，会应用安全选项。当secure = true时将使用https协议，否则secure = false将使用http协议。

当调用存储方法（如write、writeStream、url、has等）时，会应用resource_types选项以生成资源类型和public id。根据云inary资源类型注册适当的文件扩展名，例如：png在图像中，mp4在视频中，xlsx在原始文件中，对于音频文件注册在视频中。默认的资源类型是image，有关更多信息，请访问图像上传API参考。

提示

要使用预定义的文件名作为public ID上传到cloudinary，您需要在设置 -> 上传 -> 上传预设中调整一些配置，如下所示

• 点击已签名模式的预设编辑按钮，初始预设是ml_default，您可以更新它。

• 开启使用文件名或外部定义的public ID，使用预定义的文件名而不是随机字符。

• 关闭唯一文件名，防止cloudinary在文件名末尾添加随机字符。

• 点击保存，然后您就可以使用了。

许可证

Laravel Cloudinary是开源软件，许可协议为MIT许可证。