README

Less.php

这是官方 LESS 处理器的 PHP 版本。

关于

Less.php 的代码结构与上游 Less.js 保持一致，以确保兼容性并帮助减少维护工作。本移植旨在与 Less.js 3.13.1 兼容。请注意，“内联 JavaScript 表达式”（通过 eval 或反引号）不受支持。

• API § 缓存，Less.php 包含基于文件的缓存。
• API § 源映射，Less.php 支持 v3 源映射。
• API § 命令行，lessc 命令包括监视模式。

安装

您可以使用 Composer 或独立方式安装此库。

如果您已安装 Composer

1. 运行 composer require wikimedia/less.php
2. 在您的代码中使用 Less_Parser。

或独立安装

1. 下载 Less.php 并将 PHP 文件上传到您的服务器。
2. 包含库

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

3. 在您的代码中使用 Less_Parser。

安全

LESS 处理器语言功能强大，包括可能读取或嵌入服务器可访问的任意文件的功能，以及如果误用可能计算成本较高的功能。

通常，您应将 LESS 文件视为与服务器端其他可执行文件（如 PHP 代码）处于同一信任域。特别是，不建议允许使用您的 Web 服务的用户为服务器端处理提供任意 LESS 代码。

另请参阅 SECURITY。

谁使用 Less.php？

• Wikipedia 和 MediaWiki 平台 (文档)。
• Matomo (文档)。
• Magento 作为 Adobe Commerce 的组成部分 (文档)。
• Icinga 在 Icinga Web 中 (文档)。
• Shopware (文档)。
• Winter CMS (文档)

集成

Less.php 已与其他多个项目集成。

从 Leafo/lessphp 过渡

如果您正在从 Leafo/lessphp 库迁移，请使用 Less.php 附件中的 lessc.inc.php 适配器文件。

这允许 Less.php 成为 Leafo/lessphp 的直接替代品。

下载 Less.php，将文件解压到您的项目中，并包含其 lessc.inc.php。

注意：setPreserveComments 选项被忽略。Less.php 默认保留 CSS 块注释，并删除 LESS 行内注释。

Drupal

Less.php 可以通过 lessc.inc.php 适配器与 Drupal 的 less 模块 一起使用。下载 Less.php 并解压，使 lessc.inc.php 位于 sites/all/libraries/lessphp/lessc.inc.php，然后按常规安装 Drupal less 模块。

WordPress

• wp_enqueue_less 是用于 WordPress 主题和插件的 Composer 包。它提供了一个 wp_enqueue_less() 函数，用于自动管理缓存和按需编译，并在页面上加载压缩后的 CSS。
• JBST 框架 包含 Less.php 的副本。
• lessphp 插件 包含 Less.php 的副本，可用于其他插件或主题。此依赖项还可以与 TGM 库 结合使用。

致谢

Less.php 最初于 2011 年由 Matt Agar 转移到 PHP，并于 2012 年由 Martin Jantošovič 更新。从 2013 年到 2017 年，Josh Schmidt 领导了该库的开发。自 2019 年起，该库由维基媒体基金会维护。

贡献

• 问题跟踪器：https://phabricator.wikimedia.org/tag/less.php/
• 源代码：https://gerrit.wikimedia.org/g/mediawiki/libs/less.php (开始使用 Gerrit)