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

1. Download repo as a zip file and extract it to a folder named OmekaAmazonS3StorageAdapter in the plugins directory in your Omeka instance.
2. Run composer install within the plugin's folder to install the Amazon S3 PHP SDK.
3. Enable the 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

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.