https://github.com/workingconcept/craft-fortrabbit-object-storage-driver
Imager Storage Driver for fortrabbit Object Storage
https://github.com/workingconcept/craft-fortrabbit-object-storage-driver
cms craft craft-plugin craft3 craftcms fortrabbit imager
Last synced: 6 months ago
JSON representation
Imager Storage Driver for fortrabbit Object Storage
- Host: GitHub
- URL: https://github.com/workingconcept/craft-fortrabbit-object-storage-driver
- Owner: workingconcept
- License: mit
- Created: 2018-08-15T23:46:34.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2018-08-17T22:40:37.000Z (almost 8 years ago)
- Last Synced: 2025-04-12T08:46:09.748Z (about 1 year ago)
- Topics: cms, craft, craft-plugin, craft3, craftcms, fortrabbit, imager
- Language: PHP
- Size: 8.79 KB
- Stars: 3
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Imager Storage Driver for fortrabbit Object Storage
This is an external storage driver for Imager that uploads your [Imager](https://github.com/aelvan/Imager-Craft) transforms to fortrabbit's object storage. Object Storage is an AWS S3 compatible storage type, so the plugin utilizes the same S3 client as Imager's AWS storage does.
This plugin also serves as a good reference point if you want to create your own external storage driver for Imager to integrate with an unsupported third-party object storage. It's really simple, and you can do it either from a Craft 3 plugin, if you want to share it with the rest of the community (please do!), or a module, if you're using something proprietary/custom.
## Requirements
- [Craft CMS](https://github.com/craftcms/cms) 3.0.0 or later
- [Imager](https://github.com/aelvan/Imager-Craft) 2.0 or later
- [fortrabbit Pro Stack app with Object Storage](https://www.fortrabbit.com/pricing-pro) (if you have a Universal Stack app, that's a different storage type that won't work here)
## Installation
To install the plugin, follow these instructions.
1. Open your terminal and go to your Craft project:
cd /path/to/project
2. Then tell Composer to load the plugin:
composer require workingconcept/imager-fortrabbit-object-storage-driver
3. In the Control Panel, go to Settings → Plugins and click the “Install” button for "Imager Storage Driver for fortrabbit Object Storage".
## Configuration
Configure the storage driver by adding new key named `fortrabbit` to the `storagesConfig` config setting in your **imager.php config file**, with the following configuration:
'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(),
]
],
Enable the storage driver by adding the key `fortrabbit` to Imager's `storages` config setting:
'storages' => ['fortrabbit'],
Here's an example config, note that the endpoint has to be a complete URL with scheme, and as always you need to make sure that `imagerUrl` is pointed to the right location:
'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(),
]
],
Also remember to always empty your Imager transforms cache when adding or removing external storages, as the transforms won't be uploaded if the transform already exists in the cache.