Apply an asset version based on a hash of the asset for symfony/asset

Installs: 177 441

Dependents: 1

Suggesters: 0

Security: 0

Stars: 24

Watchers: 2

Forks: 5

Open Issues: 0


v1.1.1 2020-03-30 10:32 UTC

This package is auto-updated.

Last update: 2021-03-28 17:16:48 UTC


The HashedAssetBundle provides an asset version strategy which uses a hash of the file content as asset version. This allows bumping the asset version separately for each asset (automatically).

Build Status Total Downloads Latest Stable Version


Use Composer to install the bundle:

$ composer require incenteev/hashed-asset-bundle


Register the bundle in the kernel:

// app/AppKernel.php

// ...

class AppKernel extends Kernel {
    public function registerBundles()
        $bundles = array(
            // ...
            new Incenteev\HashedAssetBundle\IncenteevHashedAssetBundle(),

Then configure FrameworkBundle to use the new version strategy:

        version_strategy: incenteev_hashed_asset.strategy

Advanced configuration

The default configuration should fit common needs, but the bundle exposes a few configuration settings in case you need them:

    # Absolute path to the folder in which assets can be found
    # Note: in case you apply a base_path in your asset package, it is not
    # yet applied to the string received by the bundle
    web_root: '%kernel.project_dir%/web'
    # Format used to apply the version. This is equivalent to the
    # `framework > assets > version_format` of the static version strategy
    # of FrameworkBundle.
    version_format: '%%s?%%s'


This bundle is under the MIT license.

Alternative projects

If you want to apply cache busting by renaming files in your asset pipeline (for instance with the webpack-encore versioning feature), have a look at the json_manifest strategy available in Symfony itself.

Reporting an issue or a feature request

Issues and feature requests are tracked in the Github issue tracker.