PHPackages leuchtfeuer/aws-tools - 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. [HTTP & Networking](/categories/http) 4. / 5. leuchtfeuer/aws-tools ActiveTypo3-cms-extension[HTTP & Networking](/categories/http) leuchtfeuer/aws-tools ===================== This extension connects your TYPO3 instance to Amazon CloudFront. It rewrites all file paths in the frontend to match your CDN domain. You also have the possibility to invalidate Amazon CloudFront entries. v13.0.0(4mo ago)224.2k↓31.5%5[1 PRs](https://github.com/Leuchtfeuer/typo3-aws-tools/pulls)GPL-2.0-or-laterPHP Since Aug 20Pushed 3mo ago4 watchersCompare [ Source](https://github.com/Leuchtfeuer/typo3-aws-tools)[ Packagist](https://packagist.org/packages/leuchtfeuer/aws-tools)[ Docs](https://www.leuchtfeuer.com)[ Fund](https://www.Leuchtfeuer.com)[ RSS](/packages/leuchtfeuer-aws-tools/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (10)Dependencies (4)Versions (23)Used By (0) Amazon Web Services Tools for TYPO3 =================================== [](#amazon-web-services-tools-for-typo3) [![Latest Stable Version](https://camo.githubusercontent.com/76e0b25b92045d911910bafb839719cf68be0fd8ad041d20f1d449077fb6f99c/68747470733a2f2f706f7365722e707567782e6f72672f6c657563687466657565722f6177732d746f6f6c732f762f737461626c65)](https://packagist.org/packages/leuchtfeuer/aws-tools)[![Total Downloads](https://camo.githubusercontent.com/9838c0b0831ac6dd5875a0b13b4502ef82edc0ffb0f692bad6d918494ec8852a/68747470733a2f2f706f7365722e707567782e6f72672f6c657563687466657565722f6177732d746f6f6c732f646f776e6c6f616473)](https://packagist.org/packages/leuchtfeuer/aws-tools)[![Latest Unstable Version](https://camo.githubusercontent.com/2c2ca533d7597d92c64e5d86dc50d34a0268441243ca5b590f7edd5e295037bf/68747470733a2f2f706f7365722e707567782e6f72672f6c657563687466657565722f6177732d746f6f6c732f762f756e737461626c65)](https://packagist.org/packages/leuchtfeuer/aws-tools)[![Code Climate](https://camo.githubusercontent.com/dcb09915b3de34925700d31b1345c8f31fe33b84ab97be73d6c7c14f9758904b/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f4c657563687466657565722f7479706f332d6177732d746f6f6c732f6261646765732f6770612e737667)](https://codeclimate.com/github/Leuchtfeuer/typo3-aws-tools)[![License](https://camo.githubusercontent.com/3f26969b945e6fd7e030f84b4afafa1c7fffbda00ff64f20868c2656f6f6da67/68747470733a2f2f706f7365722e707567782e6f72672f6c657563687466657565722f6177732d746f6f6c732f6c6963656e7365)](https://packagist.org/packages/leuchtfeuer/aws-tools) This extension connects your TYPO3 instance to Amazon CloudFront. It rewrites all file paths in the frontend to match your CDN domain. You also have the possibility (at several places) to invalidate Amazon CloudFront entries. The complete documentation can be found [here](https://docs.typo3.org/p/leuchtfeuer/aws-tools/master/en-us/). Installation ------------ [](#installation) There are several ways to require and install this extension. We recommend getting this extension via composer. ### Via Composer [](#via-composer) If your TYPO3 instance is running in composer mode, you can simply require the extension by running: ``` composer req leuchtfeuer/aws-tools ``` ### Via Extension Manager [](#via-extension-manager) Open the extension manager module of your TYPO3 instance and select “Get Extensions” in the select menu above the upload button. There you can search for "aws\_tools" and simply install the extension. Please make sure you are using the latest version of the extension by updating the extension list before installing the AWS Tools extension. ### Via ZIP Archive [](#via-zip-archive) You need to download the AWS Tools extension from the [TYPO3 Extension Repository (TER)](https://extensions.typo3.org/extension/aws_tools/ "aws_tools in TER") and upload the zip file to the extension manager of your TYPO3 instance and activate the extension afterwards. Configuration ------------- [](#configuration) To activate the Content Delivery Network and to be able to invalidate Amazon CloudFront entries, several settings are necessary, which have to be carried out in different places (TypoScript, Site Configuration, Extension Configuration, ...). ### Site Configuration [](#site-configuration) The Content Delivery Network (CDN) can be enabled and configured (regardless if Amazon CloudFront is used) in the language configuration of the page configuration. The CDN can be enabled or disabled per domain and per language. [![CDN Settings within the Site Configuration](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/site-configuration.png "CDN Settings within the Site Configuration")](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/site-configuration.png) ### Rewrite File Paths [](#rewrite-file-paths) All paths to assets located in resource stores (fileadmin, etc.) are automatically rewritten by a TYPO3 interface. Since not all files are "fetched" by this mechanism, file paths (e.g. paths to stylesheets or JavaScript and fonts located in a separate site extension) configured in the TypoScript setup are rewritten by a regular expression. ``` config.tx_awstools { enabled = 1 patterns { 10 { search = "/typo3temp/ replace = "%s/typo3temp/ } 20 { search = "/typo3conf/ replace = "%s/typo3conf/ } } replacer { eventListener = 1 middleware = 1 } } ``` The "patterns" option can be extended by any number of additional entries. Each property must have the keys "search" and "replace". The `%s` in the replace property will be replaced by the previously configured CDN domain. **Please note** the quotation mark in the values of "search" and "replace". The HTML source code of the page is searched for this pattern, so that it applies to `href="/typo3temp/assets/...` for example. If the pattern did not include the quotation mark, this would lead to serious errors, as links like `href="https://cdn.example.com/typo3temp/assets/"` would be rewritten to `https://cdn.example.comhttps://cdn.example.com/typo3temp/assets/`. Additionally, the value `config` can be used to deactivate content replacement. This will disable path rewriting in frontend. There are two replacer mechanisms which can be individually enabled/disabled with the `replacer` options. `middleware` takes care of rewriting URLs within the HTML body which is generated by TYPO3. It only rewrites domains in the HTML code. If CDN domains for resources are required before rendering the HTML the option `eventListener` can be used which hooks into the GeneratePublicUrlForResourceEvent and rewrites domains directly when public URLs of resources are generated. ### Extension Configuration [](#extension-configuration) In the extension configuration you enter the access data for your AWS account (Access Key ID and Secret Access Key). In addition, you must select the region over which the requests to the AWS servers to invalidate entries should run. On the CloudFront tab, you can specify a comma-separated list of distributions where your assets are stored. [![AWS Tools extension configuration](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/extension-configuration.png "AWS Tools extension configuration")](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/extension-configuration.png) **Please note** that all entries are always invalidated simultaneously in all configured distributions. Invalidate Amazon CloudFront Entries ------------------------------------ [](#invalidate-amazon-cloudfront-entries) Amazon CloudFront entries are partially invalidated automatically or can be manually declared invalid by the user or command line calls. ### Symfony Command (CLI Only) [](#symfony-command-cli-only) Amazon CloudFront entries can be invalidated via a CLI call. The command expects one or more paths (to files or folders). ``` vendor/bin/typo3cms aws:cf:invalidate PATH_1 PATH_2 [...] PATH_X ``` The command can be executed after a deployment, for example. This command is not available as scheduler task. ### File List Module [](#file-list-module) Amazon CloudFront entries can be invalidated using the File List module. Depending on user permissions (see: below) files or whole paths can be invalidated. [![Invalidate entries in the File List module](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/file-list.png "Invalidate entries in the File List module")](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/file-list.png) #### Access Protection [](#access-protection) Appropriate permissions are required so that users can invalidate the Amazon CloudFront entries. The permissions can be granted in the backend group or user data record (`invalidateFile` or `invalidateFolder`). [![Configure permissions for users or groups](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/user-permissions.png "Configure permissions for users or groups")](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/user-permissions.png) Administrators can invalidate the entries without further permissions. #### Automatic Invalidation on Overwriting [](#automatic-invalidation-on-overwriting) Amazon CloudFront entries will be invalidated automatically after overwriting an existing file in the file list module - regardless of the authorizations of the user. ### Backend Module [](#backend-module) A dedicated backend module (only accessible for administrators) offers another possibility to invalidate Amazon CloudFront entries. The module also lists the last ten requests (per distribution) to the AWS server. [![Backend view of the AWS Tools module](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/backend-module.png "Backend view of the AWS Tools module")](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/backend-module.png) [![Backend view of the AWS Tools module after invalidating entries](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/backend-module-invalidation.png "Backend view of the AWS Tools module after invalidating entries")](https://raw.githubusercontent.com/Leuchtfeuer/typo3-aws-tools/master/Documentation/Images/backend-module-invalidation.png) ### Health Score 51 — FairBetter than 96% of packages Maintenance77 Regular maintenance activity Popularity32 Limited adoption so far Community20 Small or concentrated contributor base Maturity64 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 ~131 days Recently: every ~121 days Total 16 Last Release 123d ago Major Versions v1.0.4 → v10.0.02023-06-30 v10.0.0 → v11.0.02023-11-02 v11.0.2 → v12.0.02024-04-16 v11.0.3 → v12.0.22026-01-13 v11.0.4 → v13.0.02026-01-15 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/20301893?v=4)[Leuchtfeuer Digital Marketing](/maintainers/LeuchtfeuerDigitalMarketing)[@LeuchtfeuerDigitalMarketing](https://github.com/LeuchtfeuerDigitalMarketing) --- Top Contributors [![bitmotionAE](https://avatars.githubusercontent.com/u/33056419?v=4)](https://github.com/bitmotionAE "bitmotionAE (43 commits)")[![flossels](https://avatars.githubusercontent.com/u/8256874?v=4)](https://github.com/flossels "flossels (32 commits)")[![bmgrieger](https://avatars.githubusercontent.com/u/55093258?v=4)](https://github.com/bmgrieger "bmgrieger (7 commits)")[![bmheins](https://avatars.githubusercontent.com/u/32935316?v=4)](https://github.com/bmheins "bmheins (5 commits)")[![balasch](https://avatars.githubusercontent.com/u/68707177?v=4)](https://github.com/balasch "balasch (4 commits)")[![elbebass](https://avatars.githubusercontent.com/u/441657?v=4)](https://github.com/elbebass "elbebass (3 commits)")[![doppelD-LF](https://avatars.githubusercontent.com/u/77049101?v=4)](https://github.com/doppelD-LF "doppelD-LF (2 commits)")[![iwillenbrock](https://avatars.githubusercontent.com/u/132353832?v=4)](https://github.com/iwillenbrock "iwillenbrock (2 commits)")[![MFabse](https://avatars.githubusercontent.com/u/36532779?v=4)](https://github.com/MFabse "MFabse (2 commits)")[![davkraid](https://avatars.githubusercontent.com/u/264782?v=4)](https://github.com/davkraid "davkraid (1 commits)")[![npoggenburg](https://avatars.githubusercontent.com/u/18659807?v=4)](https://github.com/npoggenburg "npoggenburg (1 commits)")[![schliesser](https://avatars.githubusercontent.com/u/11655823?v=4)](https://github.com/schliesser "schliesser (1 commits)") --- Tags amazon-web-servicesawscdncloudfronttypo3typo3-extensionawscdntypo3cloudfrontamazon web services ### Embed Badge ![Health badge](/badges/leuchtfeuer-aws-tools/health.svg) ``` [![Health](https://phpackages.com/badges/leuchtfeuer-aws-tools/health.svg)](https://phpackages.com/packages/leuchtfeuer-aws-tools) ``` ### Alternatives [aimeos/aimeos-typo3 Professional, full-featured and high performance TYPO3 e-commerce extension for online shops and complex B2B projects 1.5k91.2k4](/packages/aimeos-aimeos-typo3)[typo3/testing-framework The TYPO3 testing framework provides base classes for unit, functional and acceptance testing. 675.0M775](/packages/typo3-testing-framework)[meema/laravel-cloudfront Easily & quickly integrate your application with AWS CloudFront. 31113.4k](/packages/meema-laravel-cloudfront)[deliciousbrains/wp-amazon-s3-and-cloudfront Automatically copies media uploads to a storage provider's bucket for delivery. Optionally configure a CDN for even faster delivery. 310213.3k1](/packages/deliciousbrains-wp-amazon-s3-and-cloudfront)[pagemachine/typo3-formlog Form log for TYPO3 23225.3k6](/packages/pagemachine-typo3-formlog)[leuchtfeuer/secure-downloads "Secure Download": Apply TYPO3 access rights to ALL file assets (PDFs, TGZs or JPGs etc. - configurable) - protect them from direct access. 22234.7k1](/packages/leuchtfeuer-secure-downloads) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)