jtgrimes/less4laravel

将lessphp引入Laravel

1.2.0 2015-08-02 04:09 UTC

README

允许您无需烦恼地使用Less(Less)在Laravel 5中,无需额外的操作。

如果您仍在使用Laravel 4,请将composer版本锁定为'~0.3'。请查看README_L4.md文件以获取更多Laravel 4的说明。

许可证

Less4Laravel是开源软件,采用MIT许可证,与Laravel使用的许可证相同。

安装

通过Composer

$ composer require jtgrimes\less4laravel

一旦Composer已安装或更新了您的包,您需要将Less4Laravel注册到Laravel本身。打开/config/app.php,找到底部的providers键并添加

'Jtgrimes\Less4laravel\LessServiceProvider'

在别名部分,添加

'Less'	=>	'Jtgrimes\Less4laravel\LessFacade'

配置

为了与配置文件一起工作,您最好使用Artisan发布一个副本。

$ php artisan vendor:publish

默认设置是

  • 当任何.less文件更新时重新编译。
  • 将.less文件缓存到/storage/framework/cache
  • 将.less文件存储在resources/assets/less
  • 将生成的.css文件存储在public/css
  • 链接到/css/filename.css
  • 不要压缩生成的css文件

您可以在/app/config/less4laravel.php中更改所有这些默认设置。

此外,您可以为开发和生产环境设置不同的配置。具体来说,您可能不希望在您的生产服务器上生成css文件,因为这会减慢您的网站速度。

为了在您的开发和生产服务器上有不同的配置,您可以这样做

打开less4laravel.config并更改

	'compile_frequency' => 'changed',

    'compile_frequency' => env('LESS4LARAVEL_FREQUENCY'),

您可以使用任何环境变量名称,L4L_FREQ只是一个例子。

在您的本地.env文件中添加

    'LESS4LARAVEL_FREQUENCY' => 'changed',

在您的生产.env文件中添加

    'LESS4LARAVEL_FREQUENCY' => 'never'

使用方法

在您的视图文件中,只需调用Less::to('file')来编译.less文件(如果需要)并生成输出css文件的链接。

如果您使用Laravel Blade,请确保不要对Less的调用进行转义

	{!! Less::to('file') !!}

要向链接添加属性,只需将它们作为第二个变量放入数组中到to函数中:Less::to('filename', ['media'=>'print'])将生成<link media="print" type="text/css" rel="stylesheet" href="https:///css/filename.css">

如果您不想让Less4Laravel生成HTML,您也可以使用Less::link()函数

	<link rel="stylesheet" href="{!! Less::link('filename') !!}">

致谢

Less4Laravel的存在离不开Leaf Corcoran的lessphp
lessphp的存在离不开LESS。Less4Laravel还需要Taylor Otwell的Laravel框架。README文件在很大程度上受到了Rob Crowe的TwigBridge的README的启发。