README

lessphp 是一个用 PHP 编写的 LESS 编译器。文档很棒，所以请查看： http://lessphp.ikimea.com/docs/。

这里有一个快速教程

lessphp 的典型流程是创建一个新的 lessc 实例，如何配置它，然后使用内置的编译方法之一告诉它编译一些内容。

compile 方法将 LESS 代码字符串编译成 CSS。

<?php

use Lessphp\Lessc;

$less = new Lessc;
echo $less->compile(".block { padding: 3 + 4px }");

compileFile 方法读取并编译一个文件。它将返回结果或将它写入由可选的第二个参数指定的路径。

<?php
echo $less->compileFile("input.less");

compileChecked 方法类似于 compileFile，但它仅在输出文件不存在或比输入文件旧时才编译。

<?php
$less->checkedCompile("input.less", "output.css");

如果在编译代码时出现任何问题，将抛出一个带有有用信息的异常。

<?php
try {
  $less->compile("invalid LESS } {");
} catch (exception $e) {
  echo "fatal error: " . $e->getMessage();
}

可以通过一系列实例方法配置 bin/lessc 对象。一些可能的配置选项包括更改输出格式、从 PHP 设置变量和控制注释的保留，写入自定义函数以及更多。所有这些都在文档中描述。

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

$ bin/plessc input.less > output.css

使用 -r 标志，您可以直接指定 LESS 代码作为参数，或者如果省略了参数，则从标准输入读取。

$ bin/plessc -r "my less code here"

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

$ plessc -w input-file output-file

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

-f 标志设置输出格式化器。例如，要压缩输出，请运行此命令：

$ bin/plessc -f=compressed myfile.less

对于更多帮助，请运行 bin/plessc --help

LessPHP 是 leafo 的倡议。另请参阅贡献者列表。

ikimea / lessphp