summaryrefslogtreecommitdiffstats
path: root/vendor/wikimedia/less.php/lib/Less/Cache.php
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-13 11:30:08 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-13 11:30:08 +0000
commit4ce65d59ca91871cfd126497158200a818720bce (patch)
treee277def01fc7eba7dbc21c4a4ae5576e8aa2cf1f /vendor/wikimedia/less.php/lib/Less/Cache.php
parentInitial commit. (diff)
downloadicinga-php-library-4ce65d59ca91871cfd126497158200a818720bce.tar.xz
icinga-php-library-4ce65d59ca91871cfd126497158200a818720bce.zip
Adding upstream version 0.13.1.upstream/0.13.1
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'vendor/wikimedia/less.php/lib/Less/Cache.php')
-rw-r--r--vendor/wikimedia/less.php/lib/Less/Cache.php276
1 files changed, 276 insertions, 0 deletions
diff --git a/vendor/wikimedia/less.php/lib/Less/Cache.php b/vendor/wikimedia/less.php/lib/Less/Cache.php
new file mode 100644
index 0000000..c8c4b44
--- /dev/null
+++ b/vendor/wikimedia/less.php/lib/Less/Cache.php
@@ -0,0 +1,276 @@
+<?php
+
+/**
+ * Utility for handling the generation and caching of css files
+ */
+class Less_Cache {
+
+ // directory less.php can use for storing data
+ public static $cache_dir = false;
+
+ // prefix for the storing data
+ public static $prefix = 'lessphp_';
+
+ // prefix for the storing vars
+ public static $prefix_vars = 'lessphpvars_';
+
+ // specifies the number of seconds after which data created by less.php will be seen as 'garbage' and potentially cleaned up
+ public static $gc_lifetime = 604800;
+
+ /**
+ * Save and reuse the results of compiled less files.
+ * The first call to Get() will generate css and save it.
+ * Subsequent calls to Get() with the same arguments will return the same css filename
+ *
+ * @param array $less_files Array of .less files to compile
+ * @param array $parser_options Array of compiler options
+ * @param array $modify_vars Array of variables
+ * @return string|false Name of the css file
+ */
+ public static function Get( $less_files, $parser_options = [], $modify_vars = [] ) {
+ // check $cache_dir
+ if ( isset( $parser_options['cache_dir'] ) ) {
+ self::$cache_dir = $parser_options['cache_dir'];
+ }
+
+ if ( empty( self::$cache_dir ) ) {
+ throw new Exception( 'cache_dir not set' );
+ }
+
+ if ( isset( $parser_options['prefix'] ) ) {
+ self::$prefix = $parser_options['prefix'];
+ }
+
+ if ( empty( self::$prefix ) ) {
+ throw new Exception( 'prefix not set' );
+ }
+
+ if ( isset( $parser_options['prefix_vars'] ) ) {
+ self::$prefix_vars = $parser_options['prefix_vars'];
+ }
+
+ if ( empty( self::$prefix_vars ) ) {
+ throw new Exception( 'prefix_vars not set' );
+ }
+
+ self::CheckCacheDir();
+ $less_files = (array)$less_files;
+
+ // create a file for variables
+ if ( !empty( $modify_vars ) ) {
+ $lessvars = Less_Parser::serializeVars( $modify_vars );
+ $vars_file = self::$cache_dir . self::$prefix_vars . sha1( $lessvars ) . '.less';
+
+ if ( !file_exists( $vars_file ) ) {
+ file_put_contents( $vars_file, $lessvars );
+ }
+
+ $less_files += [ $vars_file => '/' ];
+ }
+
+ // generate name for compiled css file
+ $hash = md5( json_encode( $less_files ) );
+ $list_file = self::$cache_dir . self::$prefix . $hash . '.list';
+
+ // check cached content
+ if ( !isset( $parser_options['use_cache'] ) || $parser_options['use_cache'] === true ) {
+ if ( file_exists( $list_file ) ) {
+
+ self::ListFiles( $list_file, $list, $cached_name );
+ $compiled_name = self::CompiledName( $list, $hash );
+
+ // if $cached_name is the same as the $compiled name, don't regenerate
+ if ( !$cached_name || $cached_name === $compiled_name ) {
+
+ $output_file = self::OutputFile( $compiled_name, $parser_options );
+
+ if ( $output_file && file_exists( $output_file ) ) {
+ @touch( $list_file );
+ return basename( $output_file ); // for backwards compatibility, we just return the name of the file
+ }
+ }
+ }
+ }
+
+ $compiled = self::Cache( $less_files, $parser_options );
+ if ( !$compiled ) {
+ return false;
+ }
+
+ $compiled_name = self::CompiledName( $less_files, $hash );
+ $output_file = self::OutputFile( $compiled_name, $parser_options );
+
+ // save the file list
+ $list = $less_files;
+ $list[] = $compiled_name;
+ $cache = implode( "\n", $list );
+ file_put_contents( $list_file, $cache );
+
+ // save the css
+ file_put_contents( $output_file, $compiled );
+
+ // clean up
+ self::CleanCache();
+
+ return basename( $output_file );
+ }
+
+ /**
+ * Force the compiler to regenerate the cached css file
+ *
+ * @param array $less_files Array of .less files to compile
+ * @param array $parser_options Array of compiler options
+ * @param array $modify_vars Array of variables
+ * @return string Name of the css file
+ */
+ public static function Regen( $less_files, $parser_options = [], $modify_vars = [] ) {
+ $parser_options['use_cache'] = false;
+ return self::Get( $less_files, $parser_options, $modify_vars );
+ }
+
+ public static function Cache( &$less_files, $parser_options = [] ) {
+ $parser_options['cache_dir'] = self::$cache_dir;
+ $parser = new Less_Parser( $parser_options );
+
+ // combine files
+ foreach ( $less_files as $file_path => $uri_or_less ) {
+
+ // treat as less markup if there are newline characters
+ if ( strpos( $uri_or_less, "\n" ) !== false ) {
+ $parser->Parse( $uri_or_less );
+ continue;
+ }
+
+ $parser->ParseFile( $file_path, $uri_or_less );
+ }
+
+ $compiled = $parser->getCss();
+
+ $less_files = $parser->allParsedFiles();
+
+ return $compiled;
+ }
+
+ private static function OutputFile( $compiled_name, $parser_options ) {
+ // custom output file
+ if ( !empty( $parser_options['output'] ) ) {
+
+ // relative to cache directory?
+ if ( preg_match( '#[\\\\/]#', $parser_options['output'] ) ) {
+ return $parser_options['output'];
+ }
+
+ return self::$cache_dir . $parser_options['output'];
+ }
+
+ return self::$cache_dir . $compiled_name;
+ }
+
+ private static function CompiledName( $files, $extrahash ) {
+ // save the file list
+ $temp = [ Less_Version::cache_version ];
+ foreach ( $files as $file ) {
+ $temp[] = filemtime( $file ) . "\t" . filesize( $file ) . "\t" . $file;
+ }
+
+ return self::$prefix . sha1( json_encode( $temp ) . $extrahash ) . '.css';
+ }
+
+ public static function SetCacheDir( $dir ) {
+ self::$cache_dir = $dir;
+ self::CheckCacheDir();
+ }
+
+ public static function CheckCacheDir() {
+ self::$cache_dir = str_replace( '\\', '/', self::$cache_dir );
+ self::$cache_dir = rtrim( self::$cache_dir, '/' ) . '/';
+
+ if ( !file_exists( self::$cache_dir ) ) {
+ if ( !mkdir( self::$cache_dir ) ) {
+ throw new Less_Exception_Parser( 'Less.php cache directory couldn\'t be created: ' . self::$cache_dir );
+ }
+
+ } elseif ( !is_dir( self::$cache_dir ) ) {
+ throw new Less_Exception_Parser( 'Less.php cache directory doesn\'t exist: ' . self::$cache_dir );
+
+ } elseif ( !is_writable( self::$cache_dir ) ) {
+ throw new Less_Exception_Parser( 'Less.php cache directory isn\'t writable: ' . self::$cache_dir );
+
+ }
+ }
+
+ /**
+ * Delete unused less.php files
+ */
+ public static function CleanCache() {
+ static $clean = false;
+
+ if ( $clean || empty( self::$cache_dir ) ) {
+ return;
+ }
+
+ $clean = true;
+
+ // only remove files with extensions created by less.php
+ // css files removed based on the list files
+ $remove_types = [ 'lesscache' => 1,'list' => 1,'less' => 1,'map' => 1 ];
+
+ $files = scandir( self::$cache_dir );
+ if ( !$files ) {
+ return;
+ }
+
+ $check_time = time() - self::$gc_lifetime;
+ foreach ( $files as $file ) {
+
+ // don't delete if the file wasn't created with less.php
+ if ( strpos( $file, self::$prefix ) !== 0 ) {
+ continue;
+ }
+
+ $parts = explode( '.', $file );
+ $type = array_pop( $parts );
+
+ if ( !isset( $remove_types[$type] ) ) {
+ continue;
+ }
+
+ $full_path = self::$cache_dir . $file;
+ $mtime = filemtime( $full_path );
+
+ // don't delete if it's a relatively new file
+ if ( $mtime > $check_time ) {
+ continue;
+ }
+
+ // delete the list file and associated css file
+ if ( $type === 'list' ) {
+ self::ListFiles( $full_path, $list, $css_file_name );
+ if ( $css_file_name ) {
+ $css_file = self::$cache_dir . $css_file_name;
+ if ( file_exists( $css_file ) ) {
+ unlink( $css_file );
+ }
+ }
+ }
+
+ unlink( $full_path );
+ }
+ }
+
+ /**
+ * Get the list of less files and generated css file from a list file
+ */
+ static function ListFiles( $list_file, &$list, &$css_file_name ) {
+ $list = explode( "\n", file_get_contents( $list_file ) );
+
+ // pop the cached name that should match $compiled_name
+ $css_file_name = array_pop( $list );
+
+ if ( !preg_match( '/^' . self::$prefix . '[a-f0-9]+\.css$/', $css_file_name ) ) {
+ $list[] = $css_file_name;
+ $css_file_name = false;
+ }
+ }
+
+}