Package to help you avoid cache by versioning your assets

0.3.3 2015-11-08 14:27 UTC


Build Status Latest Stable Version Total Downloads

Have you ever had a problem with cache in your assets? This package may help you.


Via Composer:

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

For Laravel 4.2<, use the 0.1.* version. PS: Please note that no all features are available in 0.1 version.

After that, you just need to add the following service provider to your app service providers. Open the file app/config/app.php and add this line:


And publish the configurations running the following command:

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


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

Imagine that your layout template has the following lines:

<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:

$ php artisan asset:dist

And your layout will be rendered as this:

<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.

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

You also can get only the path for some extension:

{{ 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.

For that, you need to add the HTTP2ServerPush to the middlewares of your application.

protected $middleware = [

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

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

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


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

'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.

Also, you can configure in which environments the assets are gonna be versioned.

'environments' => ['production'],


See Changelog.

Unit tests

Just run vendor/bin/phpunit.


See the License file.