PHPackages                             shopwarelabs/swag-media-s3 - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [File &amp; Storage](/categories/file-storage)
4. /
5. shopwarelabs/swag-media-s3

ActiveShopware-plugin[File &amp; Storage](/categories/file-storage)

shopwarelabs/swag-media-s3
==========================

Shopware media adapter to store media files on Amazon S3.

v2.0.0(8y ago)2185414[1 issues](https://github.com/shopwareLabs/SwagMediaS3/issues)[1 PRs](https://github.com/shopwareLabs/SwagMediaS3/pulls)MITPHP

Since Jun 27Pushed 7y ago19 watchersCompare

[ Source](https://github.com/shopwareLabs/SwagMediaS3)[ Packagist](https://packagist.org/packages/shopwarelabs/swag-media-s3)[ RSS](/packages/shopwarelabs-swag-media-s3/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (4)Dependencies (1)Versions (5)Used By (0)

Amazon S3 Adapter for Shopware
==============================

[](#amazon-s3-adapter-for-shopware)

[![https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat-square](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)The Amazon S3 adapter allows you to manage your media files in shopware on an Amazon S3 account. In addition, you can use Amazon CloudFront for delivering your files.

Building a package
------------------

[](#building-a-package)

Just run `./build.sh`.

Install
-------

[](#install)

Download the plugin from the release page and enable it in shopware.

Usage
-----

[](#usage)

Update your `config.php` in your root directory and fill in your own values:

```
'cdn' => [
    'backend' => 's3',
    'adapters' => [
        's3' => [
            'type' => 's3',
            'mediaUrl' => 'YOUR_S3_OR_CLOUDFRONT_ENDPOINT',
            'key' => 'YOUR_AWS_KEY',
            'secret' => 'YOUR_AWS_SECRET',
            'region' => 'YOUR_S3_REGION',
            'bucket' => 'YOUR_S3_BUCKET_NAME',
            'prefix' => ''
        ]
    ]
]
```

Using IAM roles in EC2
----------------------

[](#using-iam-roles-in-ec2)

To make use of your configured IAM roles, omit the array keys key and secret or leave them empty. The plugin will retrieve the credentials from the EC2 metadata service automatically.

Value explanation
-----------------

[](#value-explanation)

type (required)Adapter type. Do not change.mediaUrl (required)URL to access your media files. Usually your S3, CloudFront or custom domain endpoint

e.g.: `https://your-bucket-name.s3-website.eu-central-1.amazonaws.com/`

region (required)The S3 region, e.g. `eu-central-1`bucket (required)Your S3 bucket namekeyYour Access Key IDsecretYour Secret Access KeyprefixAn optional path prefix for your media filesendpointSets the S3 endpoint specifically (e.g. non-AWS S3)metaOptionsAllows setting options per file specific to [Flysystem S3 Adapter](https://github.com/thephpleague/flysystem-aws-s3-v3/blob/4dea5e457d046b43434824e68e64f45a8dc7eeda/src/AwsS3Adapter.php#L31)License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

36

—

LowBetter than 82% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~197 days

Total

4

Last Release

3017d ago

Major Versions

1.0.2 → v2.0.02018-02-08

### Community

Maintainers

![](https://www.gravatar.com/avatar/87bec78135aee2ab0f6ca5c7a0aae17966d8bfec3f873a81932fa65cf6621a20?d=identicon)[janbuecker](/maintainers/janbuecker)

---

Top Contributors

[![mitelg](https://avatars.githubusercontent.com/u/6985627?v=4)](https://github.com/mitelg "mitelg (8 commits)")[![janbuecker](https://avatars.githubusercontent.com/u/736986?v=4)](https://github.com/janbuecker "janbuecker (8 commits)")[![bcremer](https://avatars.githubusercontent.com/u/55820?v=4)](https://github.com/bcremer "bcremer (5 commits)")[![GerDner](https://avatars.githubusercontent.com/u/2052212?v=4)](https://github.com/GerDner "GerDner (2 commits)")[![LarsFronius](https://avatars.githubusercontent.com/u/609378?v=4)](https://github.com/LarsFronius "LarsFronius (1 commits)")[![lhwparis](https://avatars.githubusercontent.com/u/202614?v=4)](https://github.com/lhwparis "lhwparis (1 commits)")[![shyim](https://avatars.githubusercontent.com/u/6224096?v=4)](https://github.com/shyim "shyim (1 commits)")

---

Tags

s3shopwareshopware-plugins3awsshopware

### Embed Badge

![Health badge](/badges/shopwarelabs-swag-media-s3/health.svg)

```
[![Health](https://phpackages.com/badges/shopwarelabs-swag-media-s3/health.svg)](https://phpackages.com/packages/shopwarelabs-swag-media-s3)
```

###  Alternatives

[league/flysystem

File storage abstraction for PHP

13.6k639.1M2.2k](/packages/league-flysystem)[aws/aws-sdk-php

AWS SDK for PHP - Use Amazon Web Services in your PHP project

6.3k511.3M2.2k](/packages/aws-aws-sdk-php)[league/flysystem-aws-s3-v3

AWS S3 filesystem adapter for Flysystem.

1.6k263.6M790](/packages/league-flysystem-aws-s3-v3)[aws/aws-sdk-php-laravel

A simple Laravel 9/10/11/12/13 service provider for including the AWS SDK for PHP.

1.7k35.6M75](/packages/aws-aws-sdk-php-laravel)[async-aws/s3

S3 client, part of the AWS SDK provided by AsyncAws.

5714.0M32](/packages/async-aws-s3)[craftcms/aws-s3

Amazon S3 integration for Craft CMS

631.5M26](/packages/craftcms-aws-s3)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
