Dropzone S3 Extension

Official Amazon S3 and DigitalOcean Spaces storage driver for Dropzone.

Installation

Via Artisan (recommended)

php artisan dropzone:install-extension dropzone/s3

Manual Install

# Clone repository
git clone https://github.com/k2sobot/dropzone-s3.git extensions/dropzone-s3

# Install dependencies
cd extensions/dropzone-s3
composer install

# Enable in config/extensions.php
# Add: 'dropzone/s3' => true,

Configuration

Environment Variables

# Enable S3 storage
S3_ENABLED=true

# AWS S3 (default)
S3_KEY=AKIAIOSFODNN7EXAMPLE
S3_SECRET=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
S3_BUCKET=my-dropzone-bucket
S3_REGION=us-east-1

# For DigitalOcean Spaces
S3_DO_SPACES=true
S3_ENDPOINT=https://nyc3.digitaloceanspaces.com

Change Storage Driver

In config/extensions.php:

return [
    'default' => 's3', // Changed from 'local'
    'drivers' => [
        'local' => \App\Services\LocalStorageDriver::class,
        's3'    => \Dropzone\S3\Storage\S3StorageDriver::class,
    ],
    'extensions' => [
        'dropzone/s3' => true,
    ],
];

Usage

Once enabled, all new uploads will go directly to S3/S3. Download URLs will be temporary (1 hour expiry) direct from S3, reducing your server bandwidth.

Development

Testing

1. Set up an S3 bucket or DO Space
2. Configure with your keys
3. Upload a file via your Dropzone instance
4. Check CloudWatch/Space logs for file access

Local Development

git clone https://github.com/k2sobot/dropzone-s3.git
cd dropzone-s3
composer install

License

MIT