Last updated 23 August 2016. Created on 1 April 2009.
Edited by jm.federico, jweowu, m.stenta, Perignon. Log in to edit this page.

Prerequisites

Database: MySQL or PostgreSQL
Other databases are not supported and could result in unexpected behavior. MariaDB being a form fit and function replacement for MySQL seems to work fine.

Installation

- Install as you would a normal module
- A default storage class and container are created when then the module is installed.

Container Configuration with S3 via Settings.php

If you need to configure containers via code. You can now do so using settings.php. Caveat is the container must be created in the UI first to create the storage ID numbers in the database. Refer to #2325149: Allow configuration management through settings.php for details about how this works and the use-case.

An Example:

/**
 * Storage API settings
 *
 * Key would be container ID as appears in storage API config. Note that this
 * only makes sense for a specific type of deployment with predictable IDs. This
 * use case happens to be one of them.
 */
$conf['storage_api_container_settings'] = array(
  '1' => array(
    'path'     => 'sites/local/files/somewhere',
    'base_url' => 'sites/local/files/somewhere',
  ),
  '2' => array(
    'access_key_id'        => 'ACCESSKEYHERE',
    'secret_access_key'    => 'SECRETKEYHERE',
    'bucket'               => 'mybucket',
    'cname'                => 1,
    'reduced_redundancy'   => 0,
    'cloudfront'           => 0,
    'cloudfront_streaming' => 0,
    'location'             => '',
    'url_lifetime'         => 3601,
  ),
);

Links

Project page

Important Notices

If you are currently using CKEditor module (version 7.x-1.16 or earlier) and have upgraded to Storage API 1.8 and are experiencing problems. The issue revolves around the CKEditor module.

Here is the issue to reference in the Storage API queue:
#2499135: Nested storage_core_bridge_storage_access Function Call
Here is the problem in the CKEditor module queue and a patch to fix it:
#2437749: Infinity bucle in some cases in ckeditor_file_download

The fix was included in CKEditor 7.x-1.17.

Using File Streams

To use this module with some third-party modules that do not use the core file processing. You will need to install Storage API Stream Wrapper

Looking for support? Visit the Drupal.org forums, or join #drupal-support in IRC.