/** * Compiles the CSS using the engine and caches the result * @access public * @param $source Scaffold_Source * @return array */ public function compile(Scaffold_Source $source) { $id = $source->id(); $modified = $source->last_modified(); $expired = $this->cache->expired($id, $modified); if ($this->production === false or $expired === true) { $this->cache->set($id, $this->parse($source)); } $result = array(); $result['string'] = $this->cache->get($id); $result['last_modified'] = $this->cache->modified($id); return $result; }
/** * Parse the CSS. This takes an array of files, options and configs * and parses the CSS, outputing the processed CSS string. * * @param array List of files * @param array Configuration options * @param string Options * @param boolean Return the CSS rather than displaying it * @return string The processed css file as a string */ public static function parse($files, $config, $options = array(), $display = false) { # Benchmark will do the entire run from start to finish Scaffold_Benchmark::start('system'); try { # Setup the cache and other variables/constants Scaffold::setup($config); self::$options = $options; $css = false; # Time it takes to get the flags Scaffold_Benchmark::start('system.flags'); # Get the flags from each of the loaded modules. $flags = self::$flags === false ? array() : self::flags(); # Time it takes to get the flags Scaffold_Benchmark::stop('system.flags'); # The final, combined CSS file in the cache $combined = md5(serialize(array($files, $flags))) . '.css'; /** * Check if we should use the combined cache right now and skip unneeded processing */ if (SCAFFOLD_PRODUCTION === true and Scaffold_Cache::exists($combined) and Scaffold_Cache::is_fresh($combined)) { Scaffold::$output = Scaffold_Cache::open($combined); } if (Scaffold::$output === null) { # We're processing the files Scaffold_Benchmark::start('system.check_files'); foreach ($files as $file) { # The time to process a single file Scaffold_Benchmark::start('system.file.' . basename($file)); # Make sure this file is allowed if (substr($file, 0, 4) == "http" or substr($file, -4, 4) != ".css") { Scaffold::error('Scaffold cannot the requested file - ' . $file); } /** * If there are flags, we'll include them in the filename */ if (!empty($flags)) { # Webligo PHP5.1 compat $cached_file = dirname($file) . DIRECTORY_SEPARATOR . substr(basename($file), 0, strrpos(basename($file), '.')) . '_' . implode('_', $flags) . '.css'; # $cached_file = dirname($file) . DIRECTORY_SEPARATOR . pathinfo($file, PATHINFO_FILENAME) . '_' . implode('_', $flags) . '.css'; } else { $cached_file = $file; } $request = Scaffold::find_file($file, false, true); /** * While not in production, we want to to always recache, so we'll fake the time */ $modified = SCAFFOLD_PRODUCTION ? Scaffold_Cache::modified($cached_file) : 0; /** * If the CSS file has been changed, or the cached version doesn't exist */ if (!Scaffold_Cache::exists($cached_file) or $modified < filemtime($request)) { Scaffold_Cache::write(Scaffold::process($request), $cached_file); Scaffold_Cache::remove($combined); } $css .= Scaffold_Cache::open($cached_file); # The time it's taken to process this file Scaffold_Benchmark::stop('system.file.' . basename($file)); } Scaffold::$output = $css; /** * If any of the files have changed we need to recache the combined */ if (!Scaffold_Cache::exists($combined)) { Scaffold_Cache::write(self::$output, $combined); } # The time it takes to process the files Scaffold_Benchmark::stop('system.check_files'); /** * Hook to modify what is sent to the browser */ if (SCAFFOLD_PRODUCTION === false) { Scaffold::hook('display'); } } /** * Set the HTTP headers for the request. Scaffold will set * all the headers required to score an A grade on YSlow. This * means your CSS will be sent as quickly as possible to the browser. */ $length = strlen(Scaffold::$output); $modified = Scaffold_Cache::modified($combined); $lifetime = SCAFFOLD_PRODUCTION === true ? $config['cache_lifetime'] : 0; Scaffold::set_headers($modified, $lifetime, $length); /** * If the user wants us to render the CSS to the browser, we run this event. * This will send the headers and output the processed CSS. */ if ($display === true) { Scaffold::render(Scaffold::$output, $config['gzip_compression']); } # Benchmark will do the entire run from start to finish Scaffold_Benchmark::stop('system'); } catch (Exception $e) { /** * The message returned by the error */ $message = $e->getMessage(); /** * Load in the error view */ if (SCAFFOLD_PRODUCTION === false && $display === true) { Scaffold::send_headers(); require Scaffold::find_file('scaffold_error.php', 'views'); } } # Log the final execution time #$benchmark = Scaffold_Benchmark::get('system'); #Scaffold_Log::log('Total Execution - ' . $benchmark['time']); # Save the logs and exit Scaffold_Event::run('system.shutdown'); return self::$output; }