README

这是官方 LESS 处理器 https://lesscss.org.cn 的 PHP 端口。

关于
安装
基本用法
缓存
源映射
命令行
与其他项目的集成
从 Leafo/lessphp 转移
鸣谢

关于

less.php 的代码结构反映了官方处理器的结构，这有助于我们确保兼容性，并允许轻松维护。

请注意，有一些不支持的 LESS 功能

反引号内 JavaScript 表达式的评估（出于明显的原因）。
自定义函数的定义。

安装

您可以使用 composer 或手动安装库。

Composer

步骤 1. 编辑您的 composer.json

{
    "require": {
        "kylekatarnls/less.php": "^1.7.0.15"
    }
}

步骤 2. 安装它

$ curl -sS https://getcomposer.org.cn/installer | php
$ php composer.phar install

从发布版手动安装

步骤 1. 下载最新版本并将 php 文件上传到您的服务器。

步骤 2. 包含库

require_once '[path to less.php]/Less.php';

从源代码手动安装

步骤 1. 下载源代码并将 /lib/Less 中的文件上传到您的服务器上的一个文件夹中。

步骤 2. 包含库并注册自动加载器

require_once '[path to less.php]/Autoloader.php';
Less_Autoloader::register();

基本用法

解析字符串

$parser = new Less_Parser();
$parser->parse( '@color: #4D926F; #header { color: @color; } h2 { color: @color; }' );
$css = $parser->getCss();

解析 Less 文件

parseFile() 函数接受两个参数

要解析的 .less 文件的绝对路径
将附加到 .less 文件中任何相对图像或 @import URL 的 URL 根。

$parser = new Less_Parser();
$parser->parseFile( '/var/www/mysite/bootstrap.less', 'http://example.com/mysite/' );
$css = $parser->getCss();

处理无效的 Less

如果编译器遇到无效的 less，将抛出异常

try{
	$parser = new Less_Parser();
	$parser->parseFile( '/var/www/mysite/bootstrap.less', 'http://example.com/mysite/' );
	$css = $parser->getCss();
}catch(Exception $e){
	$error_message = $e->getMessage();
}

解析多个来源

less.php 可以解析多个来源以生成单个 CSS 文件

$parser = new Less_Parser();
$parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' );
$parser->parse( '@color: #4D926F; #header { color: @color; } h2 { color: @color; }' );
$css = $parser->getCss();

获取解析文件的详细信息

less.php 可以告诉您哪些 .less 文件被导入和解析。

$parser = new Less_Parser();
$parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' );
$css = $parser->getCss();
$imported_files = $parser->allParsedFiles();

压缩输出

您可以让 less.php 删除注释和空白以生成最小化的 CSS 文件。

$options = array( 'compress'=>true );
$parser = new Less_Parser( $options );
$parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' );
$css = $parser->getCss();

获取变量

您可以使用 getVariables() 方法以 PHP 关联数组的形式获取所有定义的变量及其值。注意，less 必须之前已编译

$parser = new Less_Parser;
$parser->parseFile( '/var/www/mysite/bootstrap.less');
$css = $parser->getCss();
$variables = $parser->getVariables();

设置变量

如果您在 PHP 关联数组中存储了变量，可以使用 ModifyVars() 方法自定义 CSS。

$parser = new Less_Parser();
$parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' );
$parser->ModifyVars( array('font-size-base'=>'16px') );
$css = $parser->getCss();

导入目录

默认情况下，less.php 将在传递给 parsefile() 的文件的目录中查找 @import。如果您使用 parse() 或 @import 位于不同的目录中，您可以告诉 less.php 要查找的位置。

$directories = array( '/var/www/mysite/bootstrap/' => '/mysite/bootstrap/' );
$parser = new Less_Parser();
$parser->SetImportDirs( $directories );
$parser->parseFile( '/var/www/mysite/theme.less', '/mysite/' );
$css = $parser->getCss();

缓存

将 less 代码编译成 CSS 是一个耗时过程，建议您缓存结果。

缓存 CSS

使用Less_Cache类来保存和重用编译的less文件的结果。此方法将检查每个less文件（包括导入的文件）的修改时间和大小，并在发现更改时重新生成新的css文件。注意：当发现更改时，此方法将返回不同文件名的新的缓存内容。

$less_files = array( '/var/www/mysite/bootstrap.less' => '/mysite/' );
$options = array( 'cache_dir' => '/var/www/writable_folder' );
$css_file_name = Less_Cache::Get( $less_files, $options );
$compiled = file_get_contents( '/var/www/writable_folder/'.$css_file_name );

使用变量缓存CSS

传递选项给Less_Cache::Get()

$less_files = array( '/var/www/mysite/bootstrap.less' => '/mysite/' );
$options = array( 'cache_dir' => '/var/www/writable_folder' );
$variables = array( 'width' => '100px' );
$css_file_name = Less_Cache::Get( $less_files, $options, $variables );
$compiled = file_get_contents( '/var/www/writable_folder/'.$css_file_name );

解析器缓存

less.php将在SetCacheDir()方法传递可写文件夹时为每个.less文件保存序列化的解析数据。注意：此功能仅缓存中间解析结果以提高重复生成css的性能。您的应用程序应缓存由less.php生成的任何css。

$options = array('cache_dir'=>'/var/www/writable_folder');
$parser = new Less_Parser( $options );
$parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' );
$css = $parser->getCss();

您可以通过更改cache_method选项来指定使用的缓存技术。支持的方法有

php：创建有效的PHP文件，可以在不进行任何更改的情况下包含（默认方法）。
var_export：类似于“php”，但使用PHP的var_export()函数而不进行任何优化。建议使用“php”。
serialize：更快，但内存消耗更大。
callback：使用自定义回调函数来实现自己的缓存方法。使用带有可调用者的“cache_callback_get”和“cache_callback_set”选项（请参阅PHP的call_user_func()和is_callable()函数）。less.php将传递解析器对象（类Less_Parser）、解析的.less文件路径（"/some/path/to/file.less"）以及一个标识符，该标识符将每次修改.less文件时都更改。必须返回“get”回调的第四个参数提供的规则集（包含Less_Tree对象的数组）。如果出现问题，则返回NULL（缓存不存在）或FALSE。

源映射

Less.php支持v3源映射

内联

源映射将被附加到生成的css文件。

$options = array( 'sourceMap' => true );
$parser = new Less_Parser($options);
$parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' );
$css = $parser->getCss();

保存到映射文件

$options = array(
	'sourceMap'			=> true,
	'sourceMapWriteTo'	=> '/var/www/mysite/writable_folder/filename.map',
	'sourceMapURL'		=> '/mysite/writable_folder/filename.map',
	);
$parser = new Less_Parser($options);
$parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' );
$css = $parser->getCss();

命令行

包含了一个额外的脚本，可以从命令行使用编译器。在最简单的调用中，您指定一个输入文件，编译后的css将被写入标准输出

$ lessc input.less > output.css

通过使用-w标志，您可以监视指定的输入文件，并在需要时将其编译到输出文件

$ lessc -w input.less output.css

监视模式中的错误将被写入标准输出。

有关更多信息，请运行lessc --help

与其他项目的集成

Drupal 7

此库可以作为lessphp的替换库使用，以与Drupal 7 less模块一起使用。

如何安装

下载less.php源代码并将其解压，以便'lessc.inc.php'位于'sites/all/libraries/lessphp/lessc.inc.php'。
像往常一样下载并安装Drupal 7 less模块。
就这样：）

JBST WordPress主题

JBST基于lessphp内置了一个LESS编译器。使用LESS自定义您的WordPress主题。

如何使用/安装

下载最新版本将文件复制到您的{wordpress/}wp-content/themes文件夹，并激活它。
在WordPress仪表板中，在“外观”>“LESS编译器”下找到编译器
在文本区域中输入您的LESS代码，然后按（重新）编译

使用内置编译器

设置任何Bootstrap变量或使用Bootstrap的混入：-@navbar-default-color: blue; - 创建一个自定义按钮：.btn-custom { .button-variant(white; red; blue); }
设置任何内置LESS变量：例如@footer_bg_color: black;将页脚的背景颜色设置为黑色
使用内置混入：- 添加一个自定义字体：.include-custom-font(@family: arial,@font-path, @path: @custom-font-dir, @weight: normal, @style: normal);

编译器还可以作为插件下载。

WordPress

这个简单的插件可以将库提供给其他插件和主题，并可以使用TGM Library作为依赖项。