langemike/laravel5-less

将lessphp集成到Laravel中

1.1 2015-11-23 11:24 UTC

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种选项指定配置:.envconfig.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的辛勤工作,本项目将无法实现。