Skip to content
A bundle that allows symfony to get the version of assets versioned with gulp-rev
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Build Status SensioLabsInsight

This bundle helps you using your assets versioned with gulp-rev in a symfony project by making the twig function asset return the files mapped in your gulp-rev manifest.

DEPRECATED This bundle is deprecated and will be abandoned when symfony 2.8 support finishes on November 2019. Since version 3.3, symfony includes the option json_manifest_path that does the same as this bundle, I recommend using that instead of this bundle. For previous versions the recommendation is to update symfony to a stable version and start using the option json_manifest_path.


Step 1. Download with composer

composer require irozgar/gulp-rev-versions-bundle

Step 2. Add the bundle to AppKernel

// app/AppKernel.php

class AppKernel extends Kernel
    public function registerBundles()
        $bundles = array(
            // ...
            new Irozgar\GulpRevVersionsBundle\IrozgarGulpRevVersionsBundle(),

Step 3. Configure your bundle

The configuration of the bundle depends on the symfony version

Symfony version < 3.1

Now you have to make the bundle replace the default version strategy for your assets. To make this add the following to your config.yml file:

# app/config/config.yml

    replace_default_version_strategy: ~
    # This section is needed only if you use symfony packages
    # packages in this list will use the version strategy
        - one_package
        - another_package

WARNING If your Symfony version is 3.0 you should be using the versions 1.x of twig because twig 2.0 introduced some changes that broke compatibility with that version of Symfony after its support finished (link).

Symfony version >= 3.1 && < 4.0

This symfony version introduced a new option to configure the version strategy.

Add this to your config.yml to tell symfony what version strategy it should use

# app/config/config.yml

    # ...
        version_strategy: irozgar_gulp_rev_versions.asset.gulp_rev_version_strategy
# ...

# This is only needed if using a custom path for the manifest file
    manifest_path: "your/custom/path/rev-manifest.json"

NOTE Since symfony 3.3 the framework includes a version strategy to load assets using a manifest file. more info

Configuring the manifest file path

The default location of the rev-manifest.json file is app/Resources/assets/rev-manifest.json. You can customize it by adding the following lines to your config.yml

# app/config/config.yml

    manifest_path: "your/custom/path/rev-manifest.json"

NOTE All paths will be relative to %kernel.root_dir%

You can’t perform that action at this time.