ajaxray/gulp-buster-bundle

Symfony Bundle to integrate gulp-buster npm package for cache busting

GulpBusterBundle

, _(*1)

When using gulp to manage assets of a Symfony application, this Bundle will help in cache busting with help of gulp-buster package., _(*2)

Installation

Install the latest version with, _(*3)

$ composer require ajaxray/gulp-buster-bundle

Then enable the bundle in AppKernel -
``` php <?php // app/AppKernel.php, <sub>(*4)</sub>

public function registerBundles() { $bundles = array( // ... new Ajaxray\GulpBusterBundle\GulpBusterBundle(), ); }, <sub>(*5)</sub>

## How to use
Assuming you are using **[gulp-buster](https://www.npmjs.com/package/gulp-buster)** to generate hashes for your 
web assets (javascript, css, images etc. static resources).  

Now the next thing is using those hashes with your web assets. This bundle will make it easy by adding a 
Twig Filter. Here is how to use this filter in Twig views -   

, <sub>(*6)</sub>

If a hash is found for this file, it will be appended as query string with it's url -   

, <sub>(*7)</sub>

If no hash found for this file -  

, <sub>(*8)</sub>

That's all :)


## Configuration

By default, this bundle assumes the following paths -

- busters.json (or any other name) file : `%kernel.root_dir%/../busters.json`
- web dir: `%kernel.root_dir%/../web`
- gulp dir (the dir of your gulpfile.js): `%kernel.root_dir%/..`

If any/all of the above is different for you, you can configure from your `app/config/config.yml` 
file using following keys -  

```yml
gulp_buster:  
    # if you've configured it to be in web dir    
    busters_file: "%kernel.root_dir%/../web/busters.json"    
    web_dir: "%kernel.root_dir%/relative/path/to/web/dir"    
    gulp_dir: "%kernel.root_dir%/relative/path/to/dir"