A small assetic filter for symfony to fix all url paths at css documents to correct urls

Installs: 48 005

Dependents: 2

Stars: 40

Watchers: 4

Forks: 8

Open Issues: 3

Type: symfony-bundle

v1.0.0 2013-01-04 04:20 UTC


A small assetic filter for Symfony2 to fix all url paths in css documents to correct urls. It also provides easy resource linking across platforms.


Bring in the vendor libraries

This can be done in three different ways:

Method #1) Use composer

"require": {
    "fkr/cssurlrewrite-bundle": "*"

Method #2) Use git submodules

git submodule add git:// vendor/bundles/Fkr/CssURLRewriteBundle

Method #3) Use deps file


Register the Fkr namespaces

If not using composer, register the Fkr namespace with Symfony's autoloader:

// app/autoload.php
    'Fkr' => __DIR__.'/../vendor/bundles',
    // your other namespaces

Add CssURLRewriteBundle to your application kernel

// app/AppKernel.php
public function registerBundles()
    return array(
        // ...
        new Fkr\CssURLRewriteBundle\FkrCssURLRewriteBundle(),
        // ...


# app/config.yml
    rewrite_only_if_file_exists: true
    clear_urls: true
  • rewrite_only_if_file_exists: If true (default) only rewrites url if the resource exists in the .../BundleFolder/Resources/public/ folder.
  • clear_urls: If true (default) the generated url gets normalized. For example if the url normaly is .../less/../img this option makes .../img.


Standard usage

If you place your css file for example in


and you have your images in


then you have in yours css file somthing like this

background-image: url(../img/MyImageName.png)

Now you have to call

app/console assets:install

Now if you have somthing like this in your template

{% stylesheets filter='css_url_rewrite,?yui_css' 
    <link rel="stylesheet" href="{{ asset_url }}" type="text/css" />
{% endstylesheets %}

Now the filter rewrites your url in your css file

background-image: url(../img/MyImageName.png) => background-image: url(../bundles/bundlename/css/../img/MyImageName.png)

And everything works fine.

Extended usage

You can link images from other bundles by using the @ annotation. For example if you write this in you css file

background-image: url(@BundleNameBundle/img/MyImageName.png)

Now the filter rewrite this url in your css file

background-image: url(@BundleNameBundle/img/MyImageName.png) => background-image: url(../bundles/bundlename/img/MyImageName.png)