2017 © Pedro PelĂĄez
 

library laravel-asset-versioning

Package to help you avoid cache by versioning your assets

image

escapework/laravel-asset-versioning

Package to help you avoid cache by versioning your assets

  • Saturday, October 14, 2017
  • by luisdalmolin
  • Repository
  • 8 Watchers
  • 43 Stars
  • 9,236 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 2 Forks
  • 0 Open issues
  • 31 Versions
  • 5 % Grown

The README.md

Laravel - Assets Versioning

Latest Stable Version Downloads Build Status License MIT , (*1)

Disclaimer: This package is not really maintained anymore, we recommend you use the Laravel Mix versioning instead., (*2)

Have you ever had a problem with cache in your assets? This package may help you., (*3)

Version Compatibility

Laravel Laravel Assets Versioning
6.x/7.x/8.x 0.8.x
5.5+ 0.7.x
5.4.x 0.6.x
5.3.x 0.5.x
5.2.x 0.4.x
5.1.x 0.3.x
5.0.x 0.2.x
4.2.x 0.1.x

Installation

Via Composer:, (*4)

$ composer require escapework/laravel-asset-versioning:"0.7.*"

And publish the configurations running the following command:, (*5)

$ php artisan vendor:publish --provider="EscapeWork\Assets\AssetsServiceProvider"

Usage

Instead of using the asset helper, you will need to use the Asset:v method., (*6)

Imagine that your layout template has the following lines:, (*7)

<link rel="stylesheet" href="{{ Asset::v('assets/stylesheets/css/main.css') }}">
<script src="{{ Asset::v('assets/javascripts/js/main.js') }}"></script>

In your local environment, nothing changes. But in production, you just need to run the following command every time you need to update your assets' version:, (*8)

$ php artisan asset:dist

And your layout will be rendered as this:, (*9)

<link rel="stylesheet" href="/assets/stylesheets/dist/1392745827/main.css" />
<script src="/assets/javascripts/dist/1392745827/main.js"></script>

The version is the timestamp when you performed the asset:dist command., (*10)

This package knows which folder you need by the file extension, which is the array key in the config file., (*11)

You also can get only the path for some extension:, (*12)

{{ Asset::path('css') }} <!-- /assets/stylesheets/dist/1392745827 -->

HTTP2 Server Push

You can also enable the HTTP2 Server Push header for all assets used with this package., (*13)

For that, you need to add the HTTP2ServerPush to the middlewares of your application., (*14)

protected $middleware = [
    \EscapeWork\Assets\Middleware\HTTP2ServerPush::class,
];

And that's it, your response will come with the Link HTTP header., (*15)

If you want to add some assets that are not versioned, you can use this method:, (*16)

Asset::addHTTP2Link('/assets/fonts/robotto.woff', 'font');
Asset::addHTTP2Link('/assets/css/home.css', 'css');
Asset::addHTTP2Link('/assets/js/home.js', 'js');

Configurations

Of course you can configure the folders you need. Just edit the config/assets.php file, in the types array., (*17)

'types' => [
    'css' => [
        'origin_dir' => 'your-custom-css-dir/css',
        'dist_dir'   => 'your-custom-css-dir/dist',
    ],

    'js' => [
        'origin_dir' => 'your-custom-js-dir/js',
        'dist_dir'   => 'your-custom-js-dir/dist',
    ],

    'jpg' => [
        'origin_dir' => 'assets/images',
        'dist_dir'   => 'assets/images/dist',
    ],
],

You also can add more folders by adding more items into the array., (*18)

Also, you can configure in which environments the assets are gonna be versioned., (*19)

'environments' => ['production'],

Changelog

See Changelog., (*20)

Unit tests

Just run vendor/bin/phpunit., (*21)

License

See the License file., (*22)

The Versions

14/10 2017

dev-master

9999999-dev

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=7.0.0

 

The Development Requires

by LuĂ­s Dalmolin

14/10 2017

0.7.2

0.7.2.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=7.0.0

 

The Development Requires

by LuĂ­s Dalmolin

09/10 2017

0.7.1

0.7.1.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=7.0.0

 

The Development Requires

by LuĂ­s Dalmolin

02/10 2017

0.7.0

0.7.0.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=7.0.0

 

The Development Requires

by LuĂ­s Dalmolin

15/05 2017

0.6.x-dev

0.6.9999999.9999999-dev

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

16/03 2017

0.6.1

0.6.1.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

02/02 2017

0.6.0

0.6.0.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

24/11 2016

0.5.x-dev

0.5.9999999.9999999-dev

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

24/11 2016

0.5.0

0.5.0.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

22/11 2016

0.1.x-dev

0.1.9999999.9999999-dev

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

22/11 2016

0.1.10

0.1.10.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

22/11 2016

0.1.9

0.1.9.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

01/10 2016

0.4.x-dev

0.4.9999999.9999999-dev

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

01/10 2016

0.4.0

0.4.0.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

08/11 2015

0.3.3

0.3.3.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

01/06 2015

0.3.2

0.3.2.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

01/06 2015

0.3.1

0.3.1.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

25/05 2015

0.3.0

0.3.0.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

22/05 2015

0.2.x-dev

0.2.9999999.9999999-dev

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

22/05 2015

0.2.2

0.2.2.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

22/05 2015

0.1.8

0.1.8.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

29/04 2015

0.2.1

0.2.1.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

23/03 2015

0.2.0

0.2.0.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

24/10 2014

0.1.7

0.1.7.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

24/10 2014

0.1.6

0.1.6.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

24/10 2014

0.1.5

0.1.5.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

24/07 2014

0.1.4

0.1.4.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

20/06 2014

0.1.3

0.1.3.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by LuĂ­s Dalmolin

16/04 2014

0.1.2

0.1.2.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

 

The Development Requires

by LuĂ­s Dalmolin

19/02 2014

0.1.1

0.1.1.0

Package to help you avoid cache by versioning your assets

  Sources   Download

MIT

The Requires

 

The Development Requires

by LuĂ­s Dalmolin

18/02 2014

0.1.0

0.1.0.0

Package to help you avoid cache by versioning your assets

  Sources   Download

The Requires

 

The Development Requires

by LuĂ­s Dalmolin