Skip to content

Omeka storage adapter for Amazon S3 based on the official AWS SDK.

License

Notifications You must be signed in to change notification settings

EHRI/omeka-amazon-s3-storage-adapter

Repository files navigation

Omeka Amazon S3 Storage Adapter

This is an S3 storage adapter for Omeka that provides an alternative to the Omeka_Storage_Adapter_ZendS3 which ships with the application.

The main differences are:

  • this adapter uses the official AWS SDK library
  • it requires PHP 5.5 or above
  • requires you supply the AWS region in the configuration
  • it supports the V4 authorization mechanism that is required on AWS regions created after July 2014

Usage

  1. Download the latest release from GitHub
  2. Extract it to the Omeka plugins directory
  3. Enable the AmazonS3StorageAdapter plugin in admin/plugins
  4. Add the following to your Omeka application/configuration/config.ini file:
storage.adapter = Omeka_Storage_Adapter_AmazonS3
storage.adapterOptions.accessKeyId = MY-ACCESS-KEY-ID
storage.adapterOptions.secretAccessKey = MY-SECRET-KEY
storage.adapterOptions.bucket = my-bucket-name
storage.adapterOptions.region = eu-central-1

(Being sure to set the correct bucket name and region, in addition to your access key and secret.)

To run the latest code from GitHub, rather than the last release:

  1. Download repo as a zip file
  2. Extract it to a folder named AmazonS3StorageAdapter in the plugins directory in your Omeka instance
  3. Run composer install within the plugin's folder to install the Amazon S3 PHP SDK

Note: including the AWS SDK makes this plugin package very large since there is currently no way to depend on just the S3-related parts. This will hopefully be remedied in future.