Skip to content

Latest commit

 

History

History
40 lines (30 loc) · 1.59 KB

README.md

File metadata and controls

40 lines (30 loc) · 1.59 KB
Raw

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.