Also available on GitHub
The AmazonS3 module allows the local file system to be replaced with S3. Uploads are saved into the Drupal file table using D7's file/stream wrapper system.
You can switch it on as the default file system scheme, or individually for file and image fields.
Most module configuration is handled at
admin/config/media/amazons3. At a
minimum, S3 credentials and a default bucket will need to be configured. It's
best to configure these settings in
$conf variables in
To use signed CloudFront URLs, the CloudFront private key and ID are needed.
The private key is a
.pem file, and should be stored outside of your document
$conf['amazons3_cloudfront_private_key'] to the path of the private
$conf['amazons3_cloudfront_keypair_id'] to the key ID in settings.php
to enable this feature.
- Review the patch notes below. Nearly all sites will need the very first patch
against Drupal's image module.
- Download and install Composer Manager and AmazonS3 Drupal modules.
- Enable the AmazonS3 module. It's easiest to use drush so it will
automatically download the AWS SDK.
- Configure the AmazonS3 credentials and other settings at
Patches for full functionality
While Drupal core and contrib have basic support for remote stream wrappers,
most modules have issues where they hard code URIs or specific file systems.
All of these patches except for the Imagemagick patch add simple alter hooks,
so they should be unlikely to cause problems.
needs to be patched in Drupal's image.module.
- To use Imagemagick, it must be patched to
support remote stream wrappers.
Media module, file entities, and plupload
file.incneeds to be
patched to add an alter hook.
- Media module needs to be patched
for file uploads to work with an S3 bucket.
- File Entity needs to be patched
to use correct S3 URLs.
- File Entity also needs to be patched
to work properly with the Media Internet module.
- Change individual fields to upload to S3 in the field settings
- Use AmazonS3 instead of the public file system (although there are a few issues due to core hardcoding the use of public:// in a few places e.g. aggregated CSS and JS). Go to /admin/config/media/file-system and set the default download method to Amazon.
- When using Features to export field definitions, the Upload destination is included. If you want to override this (for example, in a multi-environment workflow), use the 'amazons3fileurischemeoverride' variable. See amazons3fielddefaultfieldbases_alter() for documentation.
You can modify the generated URL and it's properties, this is very useful for setting Cache-Control and Expires headers (as long as you aren't using CloudFront).
You can also alter the metadata for each object saved to S3 with hookamazons3save_headers(). This is very useful for forcing the content-disposition header to force download files if they're being delivered through CloudFront presigned URLs.
Running PHPUnit tests
The included unit tests do not have any dependency on a Drupal installation. By
using PHPUnit, you can integrate test results into your IDE of choice.
composer installin the module directory.
In PHPStorm, it's easiest to configure PHPUnit to use the autoloader generated
in vendor/autoload.php. It's also good to mark the vendor directory as
excluded, if you already have a vendor directory indexed from composer_manager.
- Maintenance status: Actively maintained
- Development status: Under active development
- Module categories: File Management, Media, Performance and Scalability, Third-party Integration
- Reported installs: 2,149 sites currently report using this module. View usage statistics.
- Downloads: 229
- Last modified: May 5, 2015