langemike / laravel5-less
将lessphp集成到Laravel中
1.1
2015-11-23 11:24 UTC
Requires
- php: >=5.5.0
- oyejorge/less.php: ~1.5
This package is not auto-updated.
Last update: 2024-09-18 16:47:08 UTC
README
使用LESS与您的Laravel安装结合。使用 oyejorge/less.php 而不是 leafo/lessphp,后者是官方LESS处理器的更活跃的端口。
特性
- 可以实时修改LESS变量
- 可以解析自定义CSS/LESS并将其附加到结果文件
- 与Twitter Bootstrap v3.3.5兼容(感谢oyejorge/less.php)
- 缓存支持
安装
首先,通过Composer引入此包。
"require": { "langemike/laravel5-less": "~1.0" }
注意:以下安装说明在Laravel 5.5及更高版本中不再需要。
如果使用Laravel 5到5.4,请在config/app.php
中包含服务提供者。
'providers' => [ 'Langemike\Laravel5Less\LessServiceProvider' ];
在别名部分,添加
'aliases' => [ 'Less' => 'Langemike\Laravel5Less\LessFacade' ];
配置
为了与配置文件一起工作,您最好通过Artisan发布其副本
$ php artisan vendor:publish
这将创建一个位于您的配置目录中的'less.php'配置文件。
设置
您可以通过3种选项指定配置:.env
,config.php
文件和通过$options
参数。
默认情况下将使用您的.env配置,它将被config.php设置覆盖,但$options参数的优先级最高。
重新编译
此外,您可以为开发和生产使用不同的配置。具体来说,您可能不想在您的生产服务器上生成CSS文件,因为它会减慢您的网站。
- change -- 检查LESS文件是否已修改。如果是,则重新编译CSS
- none -- 不检查,不重新编译。
- always -- 总是重写CSS
用法
在您的模型或控制器中,您可以对输出的CSS进行修改。以下是一些示例:在执行重定向之前...
public function recompileCSS() { Less::modifyVars(['@body-bg' => 'pink'])->recompile('filename'); return Redirect::back(); }
在您的视图中,您可以使用Less::url()
函数来链接到您的生成的CSS
<link href="{!! Less::url('filename') !!}" rel="stylesheet" />
将true
作为Less::url()
的第二个参数传递将自动检测(根据您的配置),是否需要重新编译,并将相应地执行。
鸣谢
本项目受到Less4Laravel的启发。如果没有oyejorge/less.php的辛勤工作,本项目将无法实现。