【WordPress主题】2022年最新版完整功能demo+插件v2.1.0.zip

[](https://github.com/wikimedia/less.php/actions) [Less.php](http://lessphp.typesettercms.com) ======== This is the Wikimedia fork of a PHP port of the official LESS processor <http://lesscss.org>. * [About](#about) * [Installation](#installation) * [Basic Use](#basic-use) * [Caching](#caching) * [Source Maps](#source-maps) * [Command Line](#command-line) * [Integration with other projects](#integration-with-other-projects) * [Transitioning from Leafo/lessphp](#transitioning-from-leafolessphp) * [Credits](#credits) About --- The code structure of less.php mirrors that of the official processor which helps us ensure compatibility and allows for easy maintenance. Please note, there are a few unsupported LESS features: - Evaluation of JavaScript expressions within back-ticks (for obvious reasons). - Definition of custom functions. Installation --- You can install the library with Composer or manually. #### Composer 1. [Install Composer](https://getcomposer.org/download/) 2. Run `composer require wikimedia/less.php` #### Manually From Release Step 1. [Download a release](https://github.com/wikimedia/less.php/releases) and upload the PHP files to your server. Step 2. Include the library: ```php require_once '[path to less.php]/lib/Less/Autoloader.php'; Less_Autoloader::register(); ``` Basic Use --- #### Parsing Strings ```php $parser = new Less_Parser(); $parser->parse( '@color: #4D926F; #header { color: @color; } h2 { color: @color; }' ); $css = $parser->getCss(); ``` #### Parsing LESS Files The parseFile() function takes two arguments: 1. The absolute path of the .less file to be parsed 2. The url root to prepend to any relative image or @import urls in the .less file. ```php $parser = new Less_Parser(); $parser->parseFile( '/var/www/mysite/bootstrap.less', 'http://example.com/mysite/' ); $css = $parser->getCss(); ``` #### Handling Invalid LESS An exception will be thrown if the compiler encounters invalid LESS. ```php try{ $parser = new Less_Parser(); $parser->parseFile( '/var/www/mysite/bootstrap.less', 'http://example.com/mysite/' ); $css = $parser->getCss(); }catch(Exception $e){ $error_message = $e->getMessage(); } ``` #### Parsing Multiple Sources less.php can parse multiple sources to generate a single CSS file. ```php $parser = new Less_Parser(); $parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' ); $parser->parse( '@color: #4D926F; #header { color: @color; } h2 { color: @color; }' ); $css = $parser->getCss(); ``` #### Getting Info About The Parsed Files less.php can tell you which .less files were imported and parsed. ```php $parser = new Less_Parser(); $parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' ); $css = $parser->getCss(); $imported_files = $parser->allParsedFiles(); ``` #### Compressing Output You can tell less.php to remove comments and whitespace to generate minimized CSS files. ```php $options = array( 'compress'=>true ); $parser = new Less_Parser( $options ); $parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' ); $css = $parser->getCss(); ``` #### Getting Variables You can use the getVariables() method to get an all variables defined and their value in a php associative array. Note that LESS has to be previously compiled. ```php $parser = new Less_Parser; $parser->parseFile( '/var/www/mysite/bootstrap.less'); $css = $parser->getCss(); $variables = $parser->getVariables(); ``` #### Setting Variables You can use the ModifyVars() method to customize your CSS if you have variables stored in PHP associative arrays. ```php $parser = new Less_Parser(); $parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' ); $parser->ModifyVars( array('font-size-base'=>'16px') ); $css = $parser->getCss(); ``` #### Import Directories By default, less.php will look for @imports in the directory of the file passed to parseFile(). If you're using parse() or if @imports reside in different directories, you can tell less.php where to look. ```php $directories = array( '/var/www/mysite/bootstrap/' => '/mysite/bootstrap/' ); $parser = new Less_Parser(); $parser->SetImportDirs( $directories ); $parser->parseFile( '/var/www/mysite/theme.less', '/mysite/' ); $css = $parser->getCss(); ``` Caching --- Compiling LESS code into CSS is a time consuming process, caching your results is highly recommended. #### Caching CSS Use the Less_Cache class to save and reuse the results of compiled LESS files. This method will check the modified time and size of each LESS file (including imported files) and regenerate a new CSS file when changes are found. Note: When changes are found, this method will return a different file name for the new cached content. ```php $less_files = array( '/var/www/mysite/bootstrap.less' => '/mysite/' ); $options = array( 'cache_dir' => '/var/www/writable_folder' ); $css_file_name = Less_Cache::Get( $less_files, $options ); $compiled = file_get_contents( '/var/www/writable_folder/'.$css_file_name ); ``` #### Caching CSS With Variables Passing options to Less_Cache::Get() ```php $less_files = array( '/var/www/mysite/bootstrap.less' => '/mysite/' ); $options = array( 'cache_dir' => '/var/www/writable_folder' ); $variables = array( 'width' => '100px' ); $css_file_name = Less_Cache::Get( $less_files, $options, $variables ); $compiled = file_get_contents( '/var/www/writable_folder/'.$css_file_name ); ``` #### Parser Caching less.php will save serialized parser data for each .less file if a writable folder is passed to the SetCacheDir() method. Note: This feature only caches intermediate parsing results to improve the performance of repeated CSS generation. Your application should cache any CSS generated by less.php. ```php $options = array('cache_dir'=>'/var/www/writable_folder'); $parser = new Less_Parser( $options ); $parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' ); $css = $parser->getCss(); ``` You can specify the caching technique used by changing the ```cache_method``` option. Supported methods are: * ```php```: Creates valid PHP files which can be included without any changes (default method). * ```var_export```: Like "php", but using PHP's ```var_export()``` function without any optimizations. It's recommended to use "php" instead. * ```serialize```: Faster, but pretty memory-intense. * ```callback```: Use custom callback functions to implement your own caching method. Give the "cache_callback_get" and "cache_callback_set" options with callables (see PHP's ```call_user_func()``` and ```is_callable()``` functions). less.php will pass the parser object (class ```Less_Parser```), the path to the parsed .less file ("/some/path/to/file.less") and an identifier that will change every time the .less file is modified. The ```get``` callback must return the ruleset (an array with ```Less_Tree``` objects) provided as fourth parameter of the ```set``` callback. If something goes wrong, return ```NULL``` (cache doesn't exist) or ```FALSE```. Source Maps --- Less.php supports v3 sourcemaps #### Inline The sourcemap will be appended to the generated CSS file. ```php $options = array( 'sourceMap' => true ); $parser = new Less_Parser($options); $parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' ); $css = $parser->getCss(); ``` #### Saving to Map File ```php $options = array( 'sourceMap' => true, 'sourceMapWriteTo' => '/var/www/mysite/writable_folder/filename.map', 'sourceMapURL' => '/mysite/writable_folder/filename.map', ); $parser = new Less_Parser($options); $parser->parseFile( '/var/www/mysite/bootstrap.less', '/mysite/' ); $css = $parser->getCss(); ``` Command li