README

这是一个 Imager 的外部存储驱动程序，用于将您的Imager转换上传到 fortrabbit 的对象存储。对象存储是一种与 AWS S3 兼容的存储类型，因此插件使用了与 Imager 的 AWS 存储相同的 S3 客户端。

如果您想创建自己的外部存储驱动程序以将 Imager 与不受支持的第三方对象存储集成，此插件也是一个很好的参考点。它非常简单，您可以从 Craft 3 插件（如果您想与社区共享它，请务必这样做！）或模块（如果您使用的是专有/定制的东西）中进行操作。

要求

• Craft CMS 3.0.0 或更高版本
• Imager 2.0 或更高版本
• fortrabbit Pro Stack 应用程序带有对象存储（如果您有通用堆栈应用程序，那是一种不同的存储类型，在这里不会工作）

安装

要安装插件，请按照以下说明操作。

1. 打开您的终端并转到您的 Craft 项目

    cd /path/to/project
   

2. 然后告诉 Composer 加载插件

    composer require workingconcept/imager-fortrabbit-object-storage-driver
   

3. 在控制面板中，转到设置 → 插件，并点击 "Imager Storage Driver for fortrabbit Object Storage" 的 "安装" 按钮。

配置

通过在您的 imager.php 配置文件 中添加名为 fortrabbit 的新键到 storagesConfig 配置设置来配置存储驱动程序，以下为配置内容

'storageConfig' => [
    'fortrabbit' => [
        'endpoint' => 'https://' . getenv('OBJECT_STORAGE_SERVER'),
        'accessKey' => getenv('OBJECT_STORAGE_KEY'),
        'secretAccessKey' => getenv('OBJECT_STORAGE_SECRET'),
        'region' => getenv('OBJECT_STORAGE_REGION'),
        'bucket' => getenv('OBJECT_STORAGE_BUCKET'),
        'folder' => 'transforms',
        'requestHeaders' => array(),
    ]
],

通过向 Imager 的 storages 配置设置中添加键 fortrabbit 来启用存储驱动程序

'storages' => ['fortrabbit'],

以下是一个示例配置，请注意，端点必须是一个带有方案的完整 URL，并且始终确保 imagerUrl 指向正确的位置

'imagerUrl' => 'https://foo.objects.frb.io/transforms/',
'storages' => ['fortrabbit'],
'storageConfig' => [
    'dospaces'  => [
        'endpoint' => 'https://foo.objects.frb.io',
        'accessKey' => 'foo',
        'secretAccessKey' => '••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••••',
        'region' => 'us-east-1',
        'bucket' => 'imager-test-bucket',
        'folder' => 'transforms',
        'requestHeaders' => array(),
    ]
],

还请记住，在添加或删除外部存储时始终清空您的 Imager 转换缓存，因为如果转换已存在于缓存中，则不会上传转换。