konstantin-s/silex-assetmerge

Merging list of JS or CSS files to one. Merged files is cached to disk. Twig required.

v0.151 2016-02-12 18:23 UTC

Requires

• silex/silex: ~1.3
• symfony/twig-bridge: 2.7.*

MIT

README

Description

For boosting performance is recommended to reduce number of requests to web server.

I noticed that too many CSS and JS files are loaded at my site and decided to radically reduce their numbers by merging to one file.

Automatically, configurable, reusable.

It is my first shared project on Github and english language not my mother tongue. I am Sorry!

Installation

Via composer:

composer require konstantin-s/silex-assetmerge

See at Packagist

Usage

Register Provider

$app->register(new Performance\AssetMerge\AssetMergeProvider());

Config parameters

Register Provider with parameters

$app->register(new Performance\AssetMerge\AssetMergeProvider(), array(
    "assetmerge.config" => array(
        "active" => true,
        "alwaysReMerge" => true,
        "fetchRemote" => false,
        "mergedCssRootDir" => "/my_merged_css/",
        "mergedJsRootDir" => "/my_merged_js/"
    )
));

Usage in TWIG templade

{% set cssFiles = ["/assets/vendor/twbs/css/bootstrap.css",
"/assets/vendor/twbs/css/bootstrap-theme.css",
"/assets/vendor/prism/prism.css",
"/assets/styles/style.css"] %}
{{ app.assetmerge_config.setCssFiles(cssFiles) }}

{% set jsFiles = ["https://ajax.googleapis.com/ajax/libs/jquery/2.1.4/jquery.min.js",
"/assets/vendor/twbs/js/bootstrap.js",
"/assets/vendor/prism/prism.js",
"/assets/scripts/common.js"] %}
{{ app.assetmerge_config.setJsFiles(jsFiles) }}

{# You can set parameters, set to inactive for example:
{{ app.assetmerge_config.setactive(false) }}
#}
{{app.assetmerge_merger.getScripts|raw}}

Example output of {{app.assetmerge_merger.getScripts|raw}}

<link href="/assets/merged/6e8109cbc09fbc2b4b1543b8d1f33c14/styles.css" rel="stylesheet" type="text/css"/>
<script src="/assets/merged/df764eb96f1c811270e575caaa87de82/js.js" type="text/javascript"></script>

where 6e8109cbc09fbc2b4b1543b8d1f33c14 and df764eb96f1c811270e575caaa87de82 is md5 hashes of files names, passed to setCssFiles() and setJsFiles()