zoerb/filerevbundle

Handle asset rewrites based on json configuration

ZoerbFilerevBundle

This bundle adds support for handling asset cachbusting rewrites based on a JSON configuration. It enables you to drop assetic and use frontend tooling like grunt or gulp to build and rev your assets. The only thing you need is the rev summary provided by gulp-rev or grunt-filerev and this bundle will handle everything else., _(*1)

The summary file should look something like this:, _(*2)

{
  "/styles/main.css": "/styles/main.59983df7.css",
  "/scripts/main.js": "/scripts/main.c711a749.js"
}

Installation

Step 1: Download

composer require zoerb/filerevbundle

Step 2: Enable the bundle

Finally, enable the bundle in the kernel:, _(*3)

<?php
// app/appKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new Zoerb\Bundle\FilerevBundle\ZoerbFilerevBundle(),
    );
}

Configuration

Add the following configuration to your app/config/config.yml:, _(*4)

zoerb_filerev: ~

Options

summary_file

Type: string Default value: '%kernel.root_dir%/config/rev-manifest.json', _(*5)

Points to the rev summary file, _(*6)

enbled

Type: bool Default value: true, _(*7)

debug

Type: bool Default value: %kernel.debug%, _(*8)

root_dir

Type: string Default Value: '%kernel.root_dir%/../web', _(*9)

length

Type: int Default: 8, _(*10)

The number of characters of the file hash., _(*11)

separator

Type: string Default: ., _(*12)

The character which separates filename and hash., _(*13)

Changelog

See Changelog.md, _(*14)

Can I contribute?

Of course. We appreciate all of our contributors and welcome contributions to improve the project further. If you're uncertain whether an addition should be made, feel free to open up an issue and we can discuss it., _(*15)

License

MIT © Ben Zörb, _(*16)