wikimedia/less.php

PHP port of the LESS processor

v5.1.2 2024-11-13 15:44 UTC

Requires

• php: >=7.4.3

Requires (Dev)

• mediawiki/mediawiki-codesniffer: 45.0.0
• mediawiki/mediawiki-phan-config: 0.14.0
• mediawiki/minus-x: 1.1.3
• php-parallel-lint/php-console-highlighter: 1.0.0
• php-parallel-lint/php-parallel-lint: 1.4.0
• phpunit/phpunit: 9.6.16

Apache-2.0

• Timo Tijhof
• Josh Schmidt
• Matt Agar
• Martin Jantošovič

• php
• css
• less
• stylesheet
• less.js
• lesscss

README

Less.php

This is a PHP port of the official LESS processor.

About

The code structure of Less.php mirrors that of upstream Less.js to ensure compatibility and help reduce maintenance. The port aims to be compatible with Less.js 3.13.1. Please note that "inline JavaScript expressions" (via eval or backticks) are not supported.

• API § Caching, Less.php includes a file-based cache.
• API § Source maps, Less.php supports v3 sourcemaps.
• API § Command line, the lessc command includes a watch mode.

Installation

You can install the library with Composer or standalone.

If you have Composer installed:

1. Run composer require wikimedia/less.php
2. Use Less_Parser in your code.

Or standalone:

1. Download Less.php and upload the PHP files to your server.
2. Include the library:

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

3. Use Less_Parser in your code.

Security

The LESS processor language is powerful and includes features that may read or embed arbitrary files that the web server has access to, and features that may be computationally exensive if misused.

In general you should treat LESS files as being in the same trust domain as other server-side executables, such as PHP code. In particular, it is not recommended to allow people that use your web service to provide arbitrary LESS code for server-side processing.

See also SECURITY.

Who uses Less.php?

• Wikipedia and the MediaWiki platform (docs).
• Matomo (docs).
• Magento as part of Adobe Commerce (docs).
• Icinga in Icinga Web (docs).
• Shopware (docs).
• Winter CMS (docs)

Integrations

Less.php has been integrated with various other projects.

Transitioning from Leafo/lessphp

If you're looking to transition from the Leafo/lessphp library, use the lessc.inc.php adapter file that comes with Less.php.

This allows Less.php to be a drop-in replacement for Leafo/lessphp.

Download Less.php, unzip the files into your project, and include its lessc.inc.php instead.

Note: The setPreserveComments option is ignored. Less.php already preserves CSS block comments by default, and removes LESS inline comments.

Drupal

Less.php can be used with Drupal's less module via the lessc.inc.php adapter. Download Less.php and unzip it so that lessc.inc.php is located at sites/all/libraries/lessphp/lessc.inc.php, then install the Drupal less module as usual.

WordPress

• wp_enqueue_less is a Composer package for use in WordPress themes and plugins. It provides a wp_enqueue_less() function to automatically manage caching and compilation on-demand, and loads the compressed CSS on the page.
• JBST framework bundles a copy of Less.php.
• The lessphp plugin bundles a copy of Less.php for use in other plugins or themes. This dependency can also be combined with the TGM Library.

Credits

Less.php was originally ported to PHP in 2011 by Matt Agar and then updated by Martin Jantošovič in 2012. From 2013 to 2017, Josh Schmidt lead development of the library. Since 2019, the library is maintained by Wikimedia Foundation.

Contribute

• Issue tracker: https://phabricator.wikimedia.org/tag/less.php/
• Source code: https://gerrit.wikimedia.org/g/mediawiki/libs/less.php (Get started with Gerrit)