2017 © Pedro Peláez
 

magento2-module magento2-cache-bust

Absolute Commerce Cache Bust extension for Magento 2

image

absolute/magento2-cache-bust

Absolute Commerce Cache Bust extension for Magento 2

  • Thursday, July 26, 2018
  • by absolute
  • Repository
  • 2 Watchers
  • 5 Stars
  • 4,852 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 13 Versions
  • 35 % Grown

The README.md

Absolute Cache Bust

With Absolute Cache Bust for Magento 2 you can ensure your customers are viewing the latest version of your images, CSS and JavaScript files. This extension can be used with or without a CDN, and will also bust local versions of assets in your customers web browser cache. Find more information at https://abscom.co/cachebust., (*1)

Version Compatibility

  • For Magento 2.2.x and later please use version 3.x.x of this extension.
  • For earlier Magento versions, please use version 2.x.x of this extension.

Installation

The best way to add the extension is via composer., (*2)

composer require absolute/magento2-cache-bust

Once the extension has been added, update Magento 2 in the normal fashion., (*3)

php bin/magento setup:upgrade

Web Server Configuration

Some web server configuration is required in order for requests to yoursite.com/static/version12345/some/asset.js to resolve correctly. The intention is for the web server to ignore the segment /version12345/ and process the request as if it were not there., (*4)

Add the following to the appropriate location in your web server configuration., (*5)

Nginx

For the static cache busting, Magento already has the following in the recommended nginx configuration:, (*6)

location /static/ {
    ...

    location ~ ^/static/version {
        rewrite ^/static/(version\d*/)?(.*)$ /static/$2 last;
    }

    ...

For the media cache busting, add the following to your nginx configuration:, (*7)

location /media/ {
   ...

   location ~ ^/media/version {
       rewrite ^/media/(version\d*/)?(.*)$ /media/$2 last;
   }

   ...
}

Apache

For the static cache busting, Magento already has the following configuration in pub/static/.htaccess:, (*8)

<IfModule mod_rewrite.c>
    RewriteEngine On

    # Remove signature of the static files that is used to overcome the browser cache
    RewriteRule ^version.+?/(.+)$ $1 [L]

    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !-l

    RewriteRule .* ../static.php?resource=$0 [L]
</IfModule>

For the media cache busting, update pub/media/.htaccess with the following:, (*9)

<IfModule mod_rewrite.c>

############################################
## enable rewrites

    Options +FollowSymLinks
    RewriteEngine on

############################################
## Absolute Cache Bust
    RewriteRule ^version.+?/(.+)$ $1 [L]

############################################
## never rewrite for existing files
    RewriteCond %{REQUEST_FILENAME} !-f

############################################
## rewrite everything else to index.php

    RewriteRule .* ../get.php [L]

</IfModule>

CORS

Since Magento 2.2.x you will also need to configure your web server to allow CORS requests through, otherwise you may see errors like:, (*10)

  • ... OPTIONS ... 405 ()
  • Uncaught SyntaxError: Unexpected end of JSON input
  • Response for preflight has invalid HTTP status code 405
  • Request header field x-requested-with is not allowed
  • No 'Access-Control-Allow-Origin' header is present
  • Access has been blocked by CORS policy

You can find out more about the required configuration here: https://absolutecommerce.co.uk/cors-in-magento-2, (*11)

Usage

Once installed and configured, there are various ways to bust your Magento 2 websites cached assets., (*12)

Admin Panel Buttons

In the Magento Admin Panel go to System > Cache Management and you will see a new section at the bottom called Cache Busting. Clicking these buttons will update the dynamic element /version12345/ with a new value and then flush the appropriate Magento caches, so on their next visit your customers will download the assets afresh., (*13)

Command Line Interface (CLI)

In the Magento CLI tool you will see some new commands available, which can be used to automatically bust your cache during a deployment for example., (*14)

./bin/magento absolute:cache-bust:all
./bin/magento absolute:cache-bust:static
./bin/magento absolute:cache-bust:media

Help / Support

Need help or custom development? Find us at https://absolutecommerce.co.uk. For terms and conditions and license information, please visit https://abscom.co/terms., (*15)

The Versions

26/07 2018

dev-master

9999999-dev

Absolute Commerce Cache Bust extension for Magento 2

  Sources   Download

proprietary

26/07 2018

3.1.1

3.1.1.0

Absolute Commerce Cache Bust extension for Magento 2

  Sources   Download

proprietary

18/05 2018

3.1.0

3.1.0.0

Absolute Commerce Cache Bust extension for Magento 2

  Sources   Download

proprietary

18/05 2018

dev-update-notification-option

dev-update-notification-option

Absolute Commerce Cache Bust extension for Magento 2

  Sources   Download

proprietary

02/11 2017

3.0.0

3.0.0.0

Absolute Commerce Cache Bust extension for Magento 2

  Sources   Download

proprietary

27/10 2017

dev-bug/2.2.x-compatibility

dev-bug/2.2.x-compatibility

Absolute Commerce Cache Bust extension for Magento 2

  Sources   Download

proprietary

24/04 2017

2.3.3

2.3.3.0

Absolute Commerce Cache Bust extension for Magento 2

  Sources   Download

proprietary

24/04 2017

2.3.2

2.3.2.0

Absolute Commerce Cache Bust extension for Magento 2

  Sources   Download

proprietary

19/04 2017

2.3.1

2.3.1.0

Absolute Commerce Cache Bust extension for Magento 2

  Sources   Download

proprietary

The Requires

  • php >=5.5

 

19/04 2017

2.3.0

2.3.0.0

Absolute Commerce Cache Bust extension for Magento 2

  Sources   Download

proprietary

The Requires

  • php >=5.5

 

22/02 2017

2.1.0

2.1.0.0

Absolute Commerce Cache Bust module for Magento2.

  Sources   Download

proprietary

The Requires

  • php >=5.5

 

17/02 2017

2.0.0

2.0.0.0

Absolute Commerce Cache Bust module for Magento2.

  Sources   Download

proprietary

23/11 2016

1.0.0

1.0.0.0

Absolute Commerce CDN Cache Bust module for Magento2.

  Sources   Download

proprietary