3 require_once( dirname(__FILE__
).'/Version.php');
6 * Utility for handling the generation and caching of css files
14 // directory less.php can use for storing data
15 public static $cache_dir = false;
17 // prefix for the storing data
18 public static $prefix = 'lessphp_';
20 // prefix for the storing vars
21 public static $prefix_vars = 'lessphpvars_';
23 // specifies the number of seconds after which data created by less.php will be seen as 'garbage' and potentially cleaned up
24 public static $gc_lifetime = 604800;
28 * Save and reuse the results of compiled less files.
29 * The first call to Get() will generate css and save it.
30 * Subsequent calls to Get() with the same arguments will return the same css filename
32 * @param array $less_files Array of .less files to compile
33 * @param array $parser_options Array of compiler options
34 * @param array $modify_vars Array of variables
35 * @return string Name of the css file
37 public static function Get( $less_files, $parser_options = array(), $modify_vars = array() ){
41 if( isset($parser_options['cache_dir']) ){
42 Less_Cache
::$cache_dir = $parser_options['cache_dir'];
45 if( empty(Less_Cache
::$cache_dir) ){
46 throw new Exception('cache_dir not set');
49 if( isset($parser_options['prefix']) ){
50 Less_Cache
::$prefix = $parser_options['prefix'];
53 if( empty(Less_Cache
::$prefix) ){
54 throw new Exception('prefix not set');
57 if( isset($parser_options['prefix_vars']) ){
58 Less_Cache
::$prefix_vars = $parser_options['prefix_vars'];
61 if( empty(Less_Cache
::$prefix_vars) ){
62 throw new Exception('prefix_vars not set');
65 self
::CheckCacheDir();
66 $less_files = (array)$less_files;
69 //create a file for variables
70 if( !empty($modify_vars) ){
71 $lessvars = Less_Parser
::serializeVars($modify_vars);
72 $vars_file = Less_Cache
::$cache_dir . Less_Cache
::$prefix_vars . sha1($lessvars) . '.less';
74 if( !file_exists($vars_file) ){
75 file_put_contents($vars_file, $lessvars);
78 $less_files +
= array($vars_file => '/');
82 // generate name for compiled css file
83 $hash = md5(json_encode($less_files));
84 $list_file = Less_Cache
::$cache_dir . Less_Cache
::$prefix . $hash . '.list';
87 // check cached content
88 if( !isset($parser_options['use_cache']) ||
$parser_options['use_cache'] === true ){
89 if( file_exists($list_file) ){
91 self
::ListFiles($list_file, $list, $cached_name);
92 $compiled_name = self
::CompiledName($list);
94 // if $cached_name != $compiled_name, we know we need to recompile
95 if( !$cached_name ||
$cached_name === $compiled_name ){
97 $output_file = self
::OutputFile($compiled_name, $parser_options );
99 if( $output_file && file_exists($output_file) ){
101 return basename($output_file); // for backwards compatibility, we just return the name of the file
107 $compiled = self
::Cache( $less_files, $parser_options );
112 $compiled_name = self
::CompiledName( $less_files );
113 $output_file = self
::OutputFile($compiled_name, $parser_options );
118 $list[] = $compiled_name;
119 $cache = implode("\n",$list);
120 file_put_contents( $list_file, $cache );
124 file_put_contents( $output_file, $compiled );
130 return basename($output_file);
134 * Force the compiler to regenerate the cached css file
136 * @param array $less_files Array of .less files to compile
137 * @param array $parser_options Array of compiler options
138 * @param array $modify_vars Array of variables
139 * @return string Name of the css file
141 public static function Regen( $less_files, $parser_options = array(), $modify_vars = array() ){
142 $parser_options['use_cache'] = false;
143 return self
::Get( $less_files, $parser_options, $modify_vars );
146 public static function Cache( &$less_files, $parser_options = array() ){
149 // get less.php if it exists
150 $file = dirname(__FILE__
) . '/Less.php';
151 if( file_exists($file) && !class_exists('Less_Parser') ){
155 $parser_options['cache_dir'] = Less_Cache
::$cache_dir;
156 $parser = new Less_Parser($parser_options);
160 foreach($less_files as $file_path => $uri_or_less ){
162 //treat as less markup if there are newline characters
163 if( strpos($uri_or_less,"\n") !== false ){
164 $parser->Parse( $uri_or_less );
168 $parser->ParseFile( $file_path, $uri_or_less );
171 $compiled = $parser->getCss();
174 $less_files = $parser->allParsedFiles();
180 private static function OutputFile( $compiled_name, $parser_options ){
183 if( !empty($parser_options['output']) ){
185 //relative to cache directory?
186 if( preg_match('#[\\\\/]#',$parser_options['output']) ){
187 return $parser_options['output'];
190 return Less_Cache
::$cache_dir.$parser_options['output'];
193 return Less_Cache
::$cache_dir.$compiled_name;
197 private static function CompiledName( $files ){
200 $temp = array(Less_Version
::cache_version
);
201 foreach($files as $file){
202 $temp[] = filemtime($file)."\t".filesize($file)."\t".$file;
205 return Less_Cache
::$prefix.sha1(json_encode($temp)).'.css';
209 public static function SetCacheDir( $dir ){
210 Less_Cache
::$cache_dir = $dir;
213 public static function CheckCacheDir(){
215 Less_Cache
::$cache_dir = str_replace('\\','/',Less_Cache
::$cache_dir);
216 Less_Cache
::$cache_dir = rtrim(Less_Cache
::$cache_dir,'/').'/';
218 if( !file_exists(Less_Cache
::$cache_dir) ){
219 if( !mkdir(Less_Cache
::$cache_dir) ){
220 throw new Less_Exception_Parser('Less.php cache directory couldn\'t be created: '.Less_Cache
::$cache_dir);
223 }elseif( !is_dir(Less_Cache
::$cache_dir) ){
224 throw new Less_Exception_Parser('Less.php cache directory doesn\'t exist: '.Less_Cache
::$cache_dir);
226 }elseif( !is_writable(Less_Cache
::$cache_dir) ){
227 throw new Less_Exception_Parser('Less.php cache directory isn\'t writable: '.Less_Cache
::$cache_dir);
235 * Delete unused less.php files
238 public static function CleanCache(){
239 static $clean = false;
245 $files = scandir(Less_Cache
::$cache_dir);
247 $check_time = time() - self
::$gc_lifetime;
248 foreach($files as $file){
250 // don't delete if the file wasn't created with less.php
251 if( strpos($file,Less_Cache
::$prefix) !== 0 ){
255 $full_path = Less_Cache
::$cache_dir.'/'.$file;
257 // make sure the file still exists
258 // css files may have already been deleted
259 if( !file_exists($full_path) ){
262 $mtime = filemtime($full_path);
264 // don't delete if it's a relatively new file
265 if( $mtime > $check_time ){
269 $parts = explode('.',$file);
270 $type = array_pop($parts);
273 // delete css files based on the list files
274 if( $type === 'css' ){
279 // delete the list file and associated css file
280 if( $type === 'list' ){
281 self
::ListFiles($full_path, $list, $css_file_name);
282 if( $css_file_name ){
283 $css_file = Less_Cache
::$cache_dir.'/'.$css_file_name;
284 if( file_exists($css_file) ){
299 * Get the list of less files and generated css file from a list file
302 static function ListFiles($list_file, &$list, &$css_file_name ){
304 $list = explode("\n",file_get_contents($list_file));
306 //pop the cached name that should match $compiled_name
307 $css_file_name = array_pop($list);
309 if( !preg_match('/^' . Less_Cache
::$prefix . '[a-f0-9]+\.css$/',$css_file_name) ){
310 $list[] = $css_file_name;
311 $css_file_name = false;