zebratrois/lessphp

lessphp是一个用PHP编写的LESS编译器 - 分支以添加PHP8.1兼容性

0.5.2 2022-03-27 13:49 UTC

This package is auto-updated.

Last update: 2024-09-27 19:07:24 UTC


README

Build Status

lessphp v0.5.0

http://leafo.net/lessphp

lessphp是一个用PHP编写的LESS编译器。文档很棒,所以请查看:http://leafo.net/lessphp/docs/

这里有一个快速教程

如何在PHP项目中使用

所需文件只有一个lessc.inc.php,所以将其复制到您的包含目录。

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

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

<?php
require "lessc.inc.php";

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

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

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

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

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

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

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

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

如何从命令行使用

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

$ plessc input.less > output.css

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

$ plessc -r "my less code here"

最后,使用-w标志,您可以监视指定的输入文件,并根据需要将其编译到输出文件

$ plessc -w input-file output-file

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

-f标志设置输出格式化器。例如,为了压缩输出,请运行以下命令:

$ plessc -f=compressed myfile.less

要获取更多帮助,请运行plessc --help