gulp-rev-versions-bundle

KO | EN

gitlite — search

#javascript #react #ai #typescript #go #android #rust #deep-learning #linux #docker #java #cli #mcp #openai

gulp-rev-versions-bundle

(★ 13)

A bundle that allows symfony to get the version of assets versioned with gulp-rev

gulp-rev-versions-bundle Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

GulpRevVersionsBundle  
=====================
[![Build Status](https://travis-ci.org/irozgar/gulp-rev-versions-bundle.svg?branch=master)](https://travis-ci.org/irozgar/gulp-rev-versions-bundle)
[![SensioLabsInsight](https://insight.sensiolabs.com/projects/f85b2945-53fe-4511-b3f0-ab93111b62a2/mini.png)](https://insight.sensiolabs.com/projects/f85b2945-53fe-4511-b3f0-ab93111b62a2)

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_](http://symfony.com/doc/3.3/reference/configuration/framework.html#reference-assets-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_.

Installation
------------

### Step 1. Download with composer

```bash
composer require irozgar/gulp-rev-versions-bundle
```

### Step 2. Add the bundle to AppKernel

```php
<?php
// 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:
```yml
# app/config/config.yml

irozgar_gulp_rev_versions:
    replace_default_version_strategy: ~
    
    # This section is needed only if you use symfony packages
    # packages in this list will use the version strategy
    packages:
        - 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](https://github.com/symfony/symfony/issues/20284)).

#### 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
```yaml
# app/config/config.yml

framework:
    # ...
    assets:
        version_strategy: irozgar_gulp_rev_versions.asset.gulp_rev_version_strategy
       
# ...

# This is only needed if using a custom path for the manifest file
irozgar_gulp_rev_versions:
    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](http://symfony.com/doc/current/reference/configuration/framework.html#reference-assets-json-manifest-path)

#### 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

```yaml
# app/config/config.yml

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

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

gulp-rev-versions-bundle

gulp-rev-versions-bundle Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

gulp-rev-versions-bundle

gulp-rev-versions-bundle Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README