Zend framework css and js combine and minify module
It provides zend console route script to compile selected files as bundles and view helpers to automatically attaching bundles in your views. It can add files md5 to bundle file names - to avoid browser file caching after changes.
As bundle we understack pack of js/css files. In development mode all files from bundle are including to your site separately. In production - they are contacted and minimized to single bundle file and included in this way.
"psychowico/assets-compiler": "dev-master"to your
composer.jsonfile and run
php composer.phar update.
- Add AssetsCompiler to your
config/application.config.phpfile under the modules key.
Minifier classes provides zend console route script to compile selected files as bundles and view helpers to automatically attaching bundles in your views. It can add files md5 to bundle file names - to avoid browser file caching after changes.
To make Minifier working you need declare your bundles lists and set your local directories.
Easiest way is copy
config/autoload/minifier.global.php. Next you need proper fill configuration data
minifier key. Most options have default values, you can found their
js_adapter - js adapter configuration array
- class - adapter class (probably from \AssetsCompiler\Minifier\Adapter\)
- options - array of adapter options, you can read about them in "Adapters" section
css_adapter - css adapter configuration array, like above
development_mode - boolean flag, if true our view helper will attach all files included in bundles, one by one. If setted to true - it will attach one combined file per bundle. Default is true.
persistent_file - bundles need store some data, it is done in xml file, you can specify where this file will be save, relative to project root. Not required. By default it use "./data/minifier/config.xml" file.
public_dir - you can define your public directory here, relative to project root. Not required, By default it use "./public".
bundles - bundles configuration, can have js and css keys
Both, js and css configurations you can define by using this options:
- output_dir - output directory where bundles of this type will be saved, relative to project public directory
- list - list of bundles
List of bundles is a array where key is the bundle name, value is options array:
- filename - the bundle output filename pattern - by default it is '%s-%s'. First argument is the bundle name, second - bundle included files md5 value. Not required.
- sources - array of the bundle included files, pathes relative to project public directory
If you had configured your bundles and need combine and minify them just run your public/index.php file with cmds:
php index.php minify
It will do all job. To make it more easier and more intuitive you can create
bin folder in your project root directory. There create
minify file with
the following content:
#!/usr/bin/php <?php $_SERVER['argv'] = $argv = array_merge( $argv, array( 'minify' ) ); $_SERVER['argc'] = $argc = count($argv); require __DIR__ . '/../public/index.php';
Do not forget to give file execute access!
Now, when you are in your project root directory, you can just type:
To make life even easier you should consider use Minifer view helpers. Minfier provides two view helpers for you. You can use in very similiar way to adding normal, static js and css files.
<?php echo $this->headLink() ->prependStylesheet($this->basePath() . '/css/bootstrap-responsive.min.css') ->prependStylesheet($this->basePath() . '/css/bootstrap.min.css') ->appendBundle('css_bundle') echo $this->headScript()->prependFile($this->basePath() . '/js/bootstrap.min.js') ->prependFile($this->basePath() . '/js/jquery.min.js') ->prependBundle('js_bundle'); ?>
Bundle names are keys from above defined configuration, for sample: 'minifier'->'bundles'->'js'->'list'->'js_bundle'.
Analogously you can use prependJsBundle, prependCssBundle methods:
<?php $this->prependJsBundle('js_bundle'); echo $this->headScript(); ?>
Remember that entries will be really rendered when you will echo zf2 headScript view helper or headLink in prependCssBundle case.
Now you can simply control that zend attach js/css files list, or just bundles files - but changing development_mode flag in your Minifier configuration.
By default Minifier code use ..\Adapter\Minify adapter. It use matthiasmullie/minify php library, so you do not need install any additional stuff to start working. But if you have more needs you can use others prepared adapter or write you own. We provided three aditional adapters:
- \Adapter\Closure - using google Closure library, can compile only js
- \Adapter\UglifyJS2 - using UglifyJS2 library, only for js
- \Adapter\YUI - using YUI Compressor library from yahoo, can be use with js and css
... 'minifier' => array( 'js_adapter' => array( 'class' => 'AssetsCompiler\Minifier\Adapter\UglifyJS2', 'options' => array( 'exec' => '/uglifyjs2/path/or/link/', 'flags' => array( .. //additional compiler flags ), ), ), )
In similar way you can configure css_adapter, just remember that some adapters support only js! In exec param you need give your local path to library that you want use (Closure/UglifyJS2/YUI). In flags you can add additional parameters that will be send to compiler, for sample if you define flags like this:
... 'flags' => array( '--comments' => '', '--define' => 'DEBUG=false', ), ...
uglify will be called in something like
uglifyjs2 file1.js file2.js -o output_file.js --comments --define DEBUG=false.