README

#ZendFramework2+ LessCompiler

这是一个为Zend Framework 2+设计的模块，通过使用和扩展http://lessphp.gpeasy.com/的Less.PHP编译器，可以轻松编译所有的Less文件。

要求

本模块有以下要求

• PHP 5.3.0或更高版本。
• ZendFramework 2.2或更高版本
• 在vendor映射中包含Less.PHP编译器（默认git clone会做，或者使用composer）1.7.0或更高版本

安装

Composer

php composer.phar require  bradcrumb/bc_zf-less-compiler

或者克隆仓库

git clone https://github.com/BradCrumb/BC_ZFLessCompiler.git

加载模块

• 通过将模块名称添加到application.config.php文件中，让应用程序知道模块。例如：return array( // 这应该是一个包含应用程序中使用的模块命名空间的数组。'modules' => array( 'Application', 'BC_ZFLessCompiler', ), );
• 除非您想要设置一些自定义配置，否则现在就可以开始了

配置

由于ZF2不再对环境敏感，所以这个模块也不是。在模块的配置文件夹中，您会找到一个名为'lesscompiler.global.php.dist'的文件。要将LessCompiler配置到您的需求中，您需要将文件复制到应用程序的config/autoload文件夹中，并移除.dist扩展名。阅读ZF文档了解有关配置文件命名约定的使用方法。例如，全局也可以是局部。

您可以在module.config.php中找到可以配置的选项示例

选项有

• enable (默认：true) 是否为当前环境启用或禁用模块

• autoRun (默认：false) 总是编译Less文件（忽略启用选项）

• pathToLessphp (默认：vendor/oyejorge/less.php/lib/Less) 设置Less.PHP文件的路径 默认为应用程序的vendor映射中的"less.php"

• importDir (默认：null) 导入目录：请使用realpath(...)获取有效目录，例如realpath(getcwd() . '/less/inc/');

• sourceFolder (默认：null) 在哪里查找Less文件

• targetFolder (默认：null) 将生成的CSS放在哪里

• formatter (默认：compressed) lessphp兼容的格式化器（有关选项，请参阅leafo.net/lessphp）

• preserveComments (默认：null) 保留或删除注释

• variables (默认：array()) PHP变量数组（有关更多信息，请参阅leafo.net/lessphp）

• cache (默认：null) 以数组的形式传递缓存选项，或者传递一个扩展\Zend\Cache\Storage\Adapter\AbstractAdapter的完整缓存适配器。可配置的数组选项是键：name, ttl 和 namespace。其他数组键将被忽略

文档

当以下情况发生时，模块会自动检查并编译less文件

• autoRun在配置选项中设置为true
• 您提供了一个名为"forceCompiling"的GET参数，并将其设置为"true"或1
• 缓存时间过期

模块使用Zend_Cache的帮助来缓存编译文件。所有Less文件默认应放置在application/less目录中（在默认的public/css目录中生成CSS文件）。

默认缓存持续时间是4小时。在此之后，缓存过期，并在新的请求后，模块将检查更新的或添加的less文件。

许可协议

GNU通用公共许可证，版本3（GPL-3.0） https://open-source.org.cn/licenses/GPL-3.0