ivoba/twig-asset-version-extension

Asset Version Twig Extension

Render versioned asset filenames in twig., _(*1)

, _(*2)

Install

Use composer:, _(*3)

require ivoba/twig-asset-version-extension

Usage

In your twig files:, _(*4)

<script src="{{ asset_versioned('/dist/js/script.js') }}"></script>

This will render : /dist/js/script.12345.js, _(*5)

Where 12345 is by default the md5 content digest of the file., _(*6)

The trick is to leave the file with the original filename: /dist/js/script.js
and let the webserver rewrite the url by pattern., _(*7)

F.e, for the above pattern and apache mod_rewrite you could use:, _(*8)

RewriteRule ^dist/(.+)\.(.+)\.(js|css|png|jpg|gif)$ /dist/$1.$3 [L]

For nginx:, _(*9)

location ~* ^.+\.(dist)$ {
        rewrite ^(.+)\.(\d+)\.(dist)$ $1.$3 last;
        expires 31536000s;

Integration

Silex:

Register the Twig Extension:, _(*10)

$app['twig'] = $app->share($app->extend('twig', function ($twig, $app) {
    $twig->addExtension(new \Ivoba\AssetVersion\Twig\AssetVersionExtension(new \Ivoba\AssetVersion\Version\Md5ContentAssetVersion(),
                                                                           new \Ivoba\AssetVersion\Namer\DefaultNamer(),
                                                                            __DIR__. '/../web'));
    return $twig;
}));

Symfony:

Add this in your services.xml:, _(*11)

<service id="ivoba_asset_version.version.md5_content"
         class="Ivoba\AssetVersion\Version\Md5ContentAssetVersion">
</service>
<service id="ivoba_asset_version.namer.default"
         class="Ivoba\AssetVersion\Namer\DefaultNamer">
</service>
<service id="ivoba_asset_version.twig.asset_version_extension"
         class="Ivoba\AssetVersion\Twig\AssetVersionExtension">
    <argument type="service" id="ivoba_asset_version.version.md5_content"/>
    <argument type="service" id="ivoba_asset_version.namer.default"/>
    <argument>%asset_dir%</argument>
    <tag name="twig.extension"/>
</service>

Extend

You can create your own Version or Namer class by implementing their resp. interfaces and pass them to the extension.
F.e if you prefer timestamp as version or a different pattern in the filename., _(*12)

In the Extension you can add options as 4th parameter, as for now it only offers options['asset.directory'], as standard directory for assets., _(*13)

Credits

Read more about the idea:, _(*14)

http://www.particletree.com/notebook/automatically-version-your-css-and-javascript-files/, _(*15)

http://www.bephpug.de/folien/asset_fingerprinting_with_php_demo_2012-08-07.pdf, _(*16)