ca-dsgn / lessphp
lessphp 是一个用 PHP 编写的 LESS 编译器。
Requires (Dev)
- phpunit/phpunit: ^5.7.27
- squizlabs/php_codesniffer: 3.3.2
This package is auto-updated.
Last update: 2024-09-09 09:36:09 UTC
README
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