/yii2-less.php

This is a Yii2 wrapper extension for PHP port of the official LESS processor http://lesscss.org.

Primary LanguagePHPGNU Lesser General Public License v3.0LGPL-3.0

Yii2 Less.php

This is a Yii2 wrapper extension for PHP port of the official LESS processor http://lesscss.org.

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist cakebake/yii2-less.php "*"

or add

"cakebake/yii2-less.php": "*"

to the require section of your composer.json file.

Usage

Once the extension is installed, simply use it (without dots) in your config:

$config = [
    ...
    'components' => [
		...
        'assetManager' => [
            ...
            'converter' => [
                'class' => 'cakebake\lessphp\AssetConverter',
                'compress' => true, // Optional: You can tell less.php to remove comments and whitespace to generate minimized css files.
                'useCache' => true, // Optional: less.php will save serialized parser data for each .less file. Faster, but more memory-intense.
                //'cacheDir' => null, // Optional: is passed to the SetCacheDir() method. By default "cakebake\lessphp\runtime" is used.
                'cacheSuffix' => true, // Optional: Filename suffix to avoid the browser cache and force recompiling by configuration changes
            ],
			...
        ],
		...
	],
	...
];

So if it is configured you can specify your less files in asset bundle:

class AppAsset extends AssetBundle
{
    public $basePath = '@webroot';
    public $baseUrl = '@web';
    public $css = [
        'css/site.less',
    ];
    public $js = [
    ];
    public $depends = [
    ];
}