Get the url to a revisioned asset

, _(*2)

This Laravel 4 package enables you to get an url to a revisioned asset., _(*3)

That sounds a bit vague, right? Let me clear it up by showing an example. Calling this provided method Asset::getUrl('admin.css') returns /assets/admin.0ce5cb43.css, _(*4)

This package assumes that your asset pipeline: - saves all of your assets in one public folder. - puts a random string in the filename of every asset as a cache-busting mechanism, _(*5)

Spatie is a webdesign agency in Antwerp, Belgium. You'll find an overview of all our open source projects on our website., _(*6)

Support us

Learn how to create a package like this one, by watching our premium video course:, _(*7)

, _(*8)

We invest a lot of resources into creating best in class open source packages. You can support us by buying one of our paid products., _(*9)

We highly appreciate you sending us a postcard from your hometown, mentioning which of our package(s) you are using. You'll find our address on our contact page. We publish all received postcards on our virtual postcard wall., _(*10)

Postcardware

You're free to use this package (it's MIT-licensed), but if it makes it to your production environment you are required to send us a postcard from your hometown, mentioning which of our package(s) you are using., _(*11)

Our address is: Spatie, Kruikstraat 22, 2018 Antwerp, Belgium., _(*12)

The best postcards will get published on the open source page on our website., _(*13)

Installation

The package can be installed through Composer:, _(*14)

composer require spatie/asset-helper

This service provider must be installed:, _(*15)


//for laravel <=4.2: app/config/app.php

'providers' => [
    ...
    'Spatie\AssetHelper\AssetHelperServiceProvider'
    ...
];

This package also comes with a facade, which provides an easy way to call the the functionality., _(*16)


//for laravel <=4.2: app/config/app.php

'aliases' => array(
    ...
    'Asset' => 'Spatie\AssetHelper\AssetHelperFacade',
    ...
)

Configuration

You can publish the configuration file using this command:, _(*17)

php artisan config:publish spatie/asset-helper

A configuration-file with some sensible defaults will be placed in your config/packages directory:, _(*18)

return
    [
        /**
         * The url that points to the directory were your assets are stored
         *
         */
        'assetDirectoryUrl'         =>  '/assets',
    ];

Usage

Asset::getUrl($nonRevisionedAssetName) takes a non-revisioned asset name and it returns the url to the revisioned asset., _(*19)

Example

Let's assume the public path of your website is /home/forge/yourwebsite.be/public and that your asset pipeline stores the minified, uglified, ... and whatnot assets in this directory: /home/forge/yourwebsite.be/public/assets, _(*20)

Suppose this is the contents of that directory: - admin.0ce5cb43.css - admin.defer.adc60631.js - admin.head.1954b61c.js - front.0b4c09c7.css - front.defer.1ba6b072.js - front.head.1954b61c.js, _(*21)

As a cache-busting mechanism your asset pipeline probably puts a random string in the filename of the asset. In the example above this is '0ce5cb43', 'adc60631', '1954b61c.js', ..., _(*22)

Calling Asset::getUrl('admin.css') returns /assets/admin.0ce5cb43.css, _(*23)

So your layout file could look something like this:, _(*24)

```html+php , _(*25)

, _(*26)

... ... ...

```, _(*27)