PHPackages andersundsehr/aus-driver-amazon-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 & Storage](/categories/file-storage) 4. / 5. andersundsehr/aus-driver-amazon-s3 ActiveTypo3-cms-extension[File & Storage](/categories/file-storage) andersundsehr/aus-driver-amazon-s3 ================================== Provides a FAL driver for the Amazon Web Service AWS S3. 2.0.0(9mo ago)22259.1k↓14.6%47[15 issues](https://github.com/andersundsehr/aus_driver_amazon_s3/issues)[6 PRs](https://github.com/andersundsehr/aus_driver_amazon_s3/pulls)LGPL-3.0-or-laterPHPCI failing Since Nov 16Pushed 6mo ago7 watchersCompare [ Source](https://github.com/andersundsehr/aus_driver_amazon_s3)[ Packagist](https://packagist.org/packages/andersundsehr/aus-driver-amazon-s3)[ RSS](/packages/andersundsehr-aus-driver-amazon-s3/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (8)Versions (34)Used By (0) [![Packagist Release](https://camo.githubusercontent.com/df8b1251442218a36a595dab577d3f0f9330e2a6920447e0cd9714e6130f1f6e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f616e64657273756e64736568722f6175732d6472697665722d616d617a6f6e2d73332e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/andersundsehr/aus-driver-amazon-s3)[![Packagist Downloads](https://camo.githubusercontent.com/4af6b18de17528125927578ea61320e9e02f1fead19c151682836680edcc9750/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f616e64657273756e64736568722f6175732d6472697665722d616d617a6f6e2d73332e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/andersundsehr/aus-driver-amazon-s3)[![GitHub License](https://camo.githubusercontent.com/7fe05cfc925e7207bdd7f199d0c4a4fefa3c2e88a2ab8b907c111bb9177c395b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f616e64657273756e64736568722f6175735f6472697665725f616d617a6f6e5f73332e7376673f7374796c653d666c61742d737175617265)](https://github.com/andersundsehr/aus_driver_amazon_s3/blob/master/LICENSE.txt)[![Code Climate](https://camo.githubusercontent.com/2f2a08427df4042043bba7a609227c158505a6f6d7812b9b8362dbab9a25b8ec/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636c696d6174652f746563682d646562742f616e64657273756e64736568722f6175735f6472697665725f616d617a6f6e5f73332e7376673f7374796c653d666c61742d737175617265)](https://codeclimate.com/github/andersundsehr/aus_driver_amazon_s3)[![Contributors](https://camo.githubusercontent.com/d99e0a4407a7344016946f2c979cfe2d1302800a13cc0dfb4caf89511cbfeb2c/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f636f6e7472696275746f72732f616e64657273756e64736568722f6175735f6472697665725f616d617a6f6e5f73333f7374796c653d666c61742d737175617265)](https://github.com/andersundsehr/aus_driver_amazon_s3/graphs/contributors) TYPO3 Extension: Amazon AWS S3 FAL driver (CDN) =============================================== [](#typo3-extension-amazon-aws-s3-fal-driver-cdn) This is a driver for the file abstraction layer (FAL) to support Amazon AWS S3. You can create a file storage which allows you to upload/download and link the files to an AWS S3 bucket. It also supports the TYPO3 CMS image rendering. Requires TYPO3 11.5 - 12.4 Issue tracking: [GitHub: AWS S3 FAL Driver](https://github.com/andersundsehr/aus_driver_amazon_s3/issues) Packagist: [andersundsehr/aus-driver-amazon-s3](https://packagist.org/packages/andersundsehr/aus-driver-amazon-s3) Installation ------------ [](#installation) 1. Install the TYPO3 extension via composer (recommended) or install the extension via TER (not recommended anymore). > Composer installation: > > ``` > composer require andersundsehr/aus-driver-amazon-s3 > ``` 1. Add a new file storage with the “AWS S3” driver to root page (pid = 0). 2. Configure your file storage Configuration ------------- [](#configuration) ### Driver Configuration [](#driver-configuration) Add the following configurations: - Bucket: The name of your AWS S3 bucket - Region: The region of your bucket (avoid dots in the bucket name) - Key and secret key of your AWS account (optional, you can also use IAM roles or environment variables) - Public base url (optional): this is the public url of your bucket, if empty its default to “bucketname.s3.amazonaws.com” - Protocol: network protocol (https://, http:// or auto detection) #### Hint: Amazon AWS S3 bucket configuration [](#hint-amazon-aws-s3-bucket-configuration) Make sure that your AWS S3 bucket is accessible to public web users. For example add the following default permissions to “Edit bucket policy”: Example permissions: ``` { "Version": "2008-10-17", "Statement": [ { "Sid": "AddPerm", "Effect": "Allow", "Principal": "*", "Action": "s3:GetObject", "Resource": "arn:aws:s3:::bucketname/*" } ] } ``` ### Extension Configuration [](#extension-configuration) Edit in “Extension Manager” the following extension settings: - **dnsPrefetch** Use DNS prefetching tag: If enabled, an HTML tag will be included which prefetchs the DNS of the current CDN - **doNotLoadAmazonLib** Don’t load Amazon AWS PHP SDK: If enabled, you have to include the SDK by yourself! () - **enablePermissionsCheck** Check S3 permissions for each file and folder. This is disabled by default because it is very slow (TYPO3 has to make an AWS request for each file) ### Cache Configuration [](#cache-configuration) Customizing TYPO3 Cache Backends ================================ [](#customizing-typo3-cache-backends) - `ausdriveramazons3_metainfocache` retains metadata from AWS S3 on a per-object basis. - `ausdriveramazons3_requestcache` stores the complete response of a specific request, facilitating efficient data access and performance enhancement. By default, these caches are transient. However, if you choose to configure a persistent cache backend, it's crucial to remember that such a cache will not automatically recognize changes from the data source. In this case, it becomes your responsibility to implement the necessary updates manually. Detailed instructions on how to customize these cache backends can be found in the [TYPO3 CachingFramework Configuration Guide](https://docs.typo3.org/m/typo3/reference-coreapi/main/en-us/ApiOverview/CachingFramework/Configuration/Index.html). Remember, thorough testing is essential when modifying cache backends. Example with simple file backend; all changes through TYPO3 ``` [ 'frontend' => \TYPO3\CMS\Core\Cache\Frontend\VariableFrontend::class, 'backend' => \TYPO3\CMS\Core\Cache\Backend\SimpleFileBackend::class, 'groups' => [ 'pages' ], ]; ``` Example with redis ``` [ 'frontend' => \TYPO3\CMS\Core\Cache\Frontend\VariableFrontend::class, 'backend' => \TYPO3\CMS\Core\Cache\Backend\RedisBackend::class, 'options' => [ 'defaultLifetime' => 0, // infinite 'database' => 0, 'hostname' => 'redis', 'port' => 6379, ], ]; ``` Extend Extension ---------------- [](#extend-extension) ### Initialize S3 Client [](#initialize-s3-client) If you use your own Amazon AWS SDK, you may want to work with your own S3 client object. So you have to use the following hook in your own ext\_loaclconf.php: ``` $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['aus_driver_amazon_s3']['initializeClient-preProcessing'][] = \Vendor\ExtensionName\Hooks\AmazonS3DriverHook::class . '->initializeClient'; ``` A hook class might look like this: ``` namespace Vendor\ExtensionName\Hooks; class AmazonS3DriverHook { public function initializeClient(array &$params, $obj){ $params['s3Client'] = MyAwsFactory::getAwsS3Client($params['configuration']); } } ``` ### Initialize public base URL [](#initialize-public-base-url) You can set the public base URL in the configuration of your driver (TYPO3 backend). But maybe you want to set this on an other place. So you have to use the following hook in your own ext\_loaclconf.php: ``` $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['aus_driver_amazon_s3']['initializeBaseUrl-postProcessing'][] = \Vendor\ExtensionName\Hooks\AmazonS3DriverHook::class . '->initializeBaseUrl'; ``` A hook class might look like this: ``` namespace Vendor\ExtensionName\Hooks; class AmazonS3DriverHook { public function initializeBaseUrl(array &$params, $obj){ $params['baseUrl'] = 'https://example.com'; } } ``` ### Cache Control Header [](#cache-control-header) There is a default setting to set the cache control header's max age for all file types. If you want to use special cache headers, you can use this hook: ``` $GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['aus_driver_amazon_s3']['getCacheControl'][] = 'Vendor\ExtensionName\Hooks\AmazonS3DriverHook->getCacheControl'; ``` You can modify the parameter "cacheControl" as you wish. Please Notice: AWS S3 set the cache header only once - while uploading / creating or copy the file. ### More [](#more) If you wish other hooks - don’t be shy: [GitHub issue tracking: Amazon S3 FAL Driver](https://github.com/andersundsehr/aus_driver_amazon_s3/issues) Development =========== [](#development) Running tests ------------- [](#running-tests) Run `make tests` to run both unit and functional tests. To switch TYPO3 test version to 11: ``` composer update --with typo3/cms-core:^11.5.6 ``` To switch TYPO3 test version to 12: ``` composer update --with typo3/cms-core:^12.4.0 --ignore-platform-req=ext-intl ``` ### Health Score 53 — FairBetter than 97% of packages Maintenance49 Moderate activity, may be stable Popularity47 Moderate usage in the ecosystem Community30 Small or concentrated contributor base Maturity74 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 ~136 days Recently: every ~32 days Total 27 Last Release 286d ago Major Versions 1.13.5 → 2.0.02025-08-05 PHP version history (4 changes)1.6.0PHP >=5.6.0 1.8.0PHP >=7.0.0 1.11.0PHP >=7.2 1.13.0PHP >=7.4 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/471387?v=4)[Matthias Vogel](/maintainers/Kanti)[@Kanti](https://github.com/Kanti) ![](https://www.gravatar.com/avatar/39af3f9c14f1d619d2584ae31552504f2f12424a947ee8d8c7a64e1ef23f47d2?d=identicon)[lagerregal](/maintainers/lagerregal) ![](https://www.gravatar.com/avatar/ce27306c234536251754f00414959671d4a775e9cf57cce2f5ea1dca158183d6?d=identicon)[andersundsehr](/maintainers/andersundsehr) --- Top Contributors [![Lagerregal](https://avatars.githubusercontent.com/u/2297740?v=4)](https://github.com/Lagerregal "Lagerregal (138 commits)")[![weakbit](https://avatars.githubusercontent.com/u/12049749?v=4)](https://github.com/weakbit "weakbit (58 commits)")[![cweiske](https://avatars.githubusercontent.com/u/59036?v=4)](https://github.com/cweiske "cweiske (41 commits)")[![DanielSiepmann](https://avatars.githubusercontent.com/u/354250?v=4)](https://github.com/DanielSiepmann "DanielSiepmann (8 commits)")[![Kanti](https://avatars.githubusercontent.com/u/471387?v=4)](https://github.com/Kanti "Kanti (6 commits)")[![mjonuschat](https://avatars.githubusercontent.com/u/203423?v=4)](https://github.com/mjonuschat "mjonuschat (3 commits)")[![ayacoo](https://avatars.githubusercontent.com/u/5963331?v=4)](https://github.com/ayacoo "ayacoo (3 commits)")[![helhum](https://avatars.githubusercontent.com/u/904370?v=4)](https://github.com/helhum "helhum (2 commits)")[![tgriessbach](https://avatars.githubusercontent.com/u/11647324?v=4)](https://github.com/tgriessbach "tgriessbach (2 commits)")[![ltrebing](https://avatars.githubusercontent.com/u/446115?v=4)](https://github.com/ltrebing "ltrebing (2 commits)")[![ipf](https://avatars.githubusercontent.com/u/557076?v=4)](https://github.com/ipf "ipf (1 commits)")[![Atsyn](https://avatars.githubusercontent.com/u/10295779?v=4)](https://github.com/Atsyn "Atsyn (1 commits)")[![berndbrot](https://avatars.githubusercontent.com/u/4488987?v=4)](https://github.com/berndbrot "berndbrot (1 commits)")[![birgerstoeckelmann](https://avatars.githubusercontent.com/u/10415259?v=4)](https://github.com/birgerstoeckelmann "birgerstoeckelmann (1 commits)")[![mediaessenz](https://avatars.githubusercontent.com/u/16038153?v=4)](https://github.com/mediaessenz "mediaessenz (1 commits)")[![m-knabe-reply](https://avatars.githubusercontent.com/u/11394324?v=4)](https://github.com/m-knabe-reply "m-knabe-reply (1 commits)")[![Moongazer](https://avatars.githubusercontent.com/u/1685510?v=4)](https://github.com/Moongazer "Moongazer (1 commits)")[![mxbeer](https://avatars.githubusercontent.com/u/6144052?v=4)](https://github.com/mxbeer "mxbeer (1 commits)")[![sbuerk](https://avatars.githubusercontent.com/u/1453466?v=4)](https://github.com/sbuerk "sbuerk (1 commits)")[![vertexvaar](https://avatars.githubusercontent.com/u/5594393?v=4)](https://github.com/vertexvaar "vertexvaar (1 commits)") --- Tags amazon-aws-sdkamazon-s3-driverhacktoberfeststoragetypo3typo3-extension ### Embed Badge ![Health badge](/badges/andersundsehr-aus-driver-amazon-s3/health.svg) ``` [![Health](https://phpackages.com/badges/andersundsehr-aus-driver-amazon-s3/health.svg)](https://phpackages.com/packages/andersundsehr-aus-driver-amazon-s3) ``` ### Alternatives [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)[humanmade/s3-uploads WordPress plugin to store uploads on S3 2.1k2.4M9](/packages/humanmade-s3-uploads)[causal/image_autoresize Simplify the way your editors may upload their images: no complex local procedure needed, let TYPO3 automatically resize down their huge images/pictures on-the-fly during upload (or using a command for batch processing) and according to your own business rules (directory/groups). This will highly reduce the footprint on your server and speed-up response time if lots of images are rendered (e.g., in a gallery). Features an EXIF/IPTC extractor to ensure metadata may be used by the FAL indexer even if not preserved upon resizing. 19455.6k](/packages/causal-image-autoresize)[hmmh/solr-file-indexer Solr file indexer for Typo3 13217.4k3](/packages/hmmh-solr-file-indexer)[maxserv/fal_s3 Connect FAL/TYPO3 to any of the configured S3 buckets with a few clicks. File based configuration allows specific buckets depending on the context of your application. 1584.1k](/packages/maxserv-fal-s3) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)