class SassFile in Sassy 7
Same name and namespace in other branches
- 7.3 phpsass/SassFile.php \SassFile
SassFile class. @package PHamlP @subpackage Sass
Hierarchy
- class \SassFile
Expanded class hierarchy of SassFile
File
- phamlp/
sass/ SassFile.php, line 18
View source
class SassFile {
const SASS = 'sass';
const SCSS = 'scss';
const SASSC = 'sassc';
private static $extensions = array(
self::SASS,
self::SCSS,
);
/**
* Returns the parse tree for a file.
* If caching is enabled a cached version will be used if possible; if not the
* parsed file will be cached.
* @param string filename to parse
* @param SassParser Sass parser
* @return SassRootNode
*/
public static function getTree($filename, $parser) {
if ($parser->cache) {
$cached = self::getCachedFile($filename, $parser->cache_location);
if ($cached !== false) {
return $cached;
}
}
$sassParser = new SassParser(array_merge($parser->options, array(
'line' => 1,
)));
$tree = $sassParser
->parse($filename);
if ($parser->cache) {
self::setCachedFile($tree, $filename, $parser->cache_location);
}
return $tree;
}
/**
* Returns the full path to a file to parse.
* The file is looked for recursively under the load_paths directories and
* the template_location directory.
* If the filename does not end in .sass or .scss try the current syntax first
* then, if a file is not found, try the other syntax.
* @param string filename to find
* @param SassParser Sass parser
* @return string path to file
* @throws SassException if file not found
*/
public static function getFile($filename, $parser) {
$ext = substr($filename, -5);
foreach (self::$extensions as $i => $extension) {
if ($ext !== '.' . self::SASS && $ext !== '.' . self::SCSS) {
if ($i === 0) {
$_filename = "{$filename}.{$parser->syntax}";
}
else {
$_filename = $filename . '.' . ($parser->syntax === self::SASS ? self::SCSS : self::SASS);
}
}
else {
$_filename = $filename;
}
if (file_exists($_filename)) {
return $_filename;
}
$paths = $parser->load_paths;
if (!empty($parser->filename)) {
$paths[] = dirname($parser->filename);
}
foreach ($paths as $loadPath) {
$path = self::findFile($_filename, realpath($loadPath));
if ($path !== false) {
return $path;
}
}
// foreach
if (!empty($parser->template_location)) {
$path = self::findFile($_filename, realpath($parser->template_location));
if ($path !== false) {
return $path;
}
}
}
throw new SassException('Unable to find {what}: {filename}', array(
'{what}' => 'import file',
'{filename}' => $filename,
));
}
/**
* Looks for the file recursively in the specified directory.
* This will also look for _filename to handle Sass partials.
* @param string filename to look for
* @param string path to directory to look in and under
* @return mixed string: full path to file if found, false if not
*/
public static function findFile($filename, $dir) {
$partialname = dirname($filename) . DIRECTORY_SEPARATOR . '_' . basename($filename);
foreach (array(
$filename,
$partialname,
) as $file) {
if (file_exists($dir . DIRECTORY_SEPARATOR . $file)) {
return realpath($dir . DIRECTORY_SEPARATOR . $file);
}
}
$files = array_slice(scandir($dir), 2);
foreach ($files as $file) {
if (is_dir($dir . DIRECTORY_SEPARATOR . $file)) {
$path = self::findFile($filename, $dir . DIRECTORY_SEPARATOR . $file);
if ($path !== false) {
return $path;
}
}
}
// foreach
return false;
}
/**
* Returns a cached version of the file if available.
* @param string filename to fetch
* @param string path to cache location
* @return mixed the cached file if available or false if it is not
*/
public static function getCachedFile($filename, $cacheLocation) {
$cached = realpath($cacheLocation) . DIRECTORY_SEPARATOR . md5($filename) . '.' . self::SASSC;
if ($cached && file_exists($cached) && filemtime($cached) >= filemtime($filename)) {
return unserialize(file_get_contents($cached));
}
return false;
}
/**
* Saves a cached version of the file.
* @param SassRootNode Sass tree to save
* @param string filename to save
* @param string path to cache location
* @return mixed the cached file if available or false if it is not
*/
public static function setCachedFile($sassc, $filename, $cacheLocation) {
$cacheDir = realpath($cacheLocation);
if (!$cacheDir) {
mkdir($cacheLocation);
@chmod($cacheLocation, 0777);
$cacheDir = realpath($cacheLocation);
}
$cached = $cacheDir . DIRECTORY_SEPARATOR . md5($filename) . '.' . self::SASSC;
return file_put_contents($cached, serialize($sassc));
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
SassFile:: |
private static | property | ||
SassFile:: |
public static | function | * Looks for the file recursively in the specified directory. * This will also look for _filename to handle Sass partials. * | |
SassFile:: |
public static | function | * Returns a cached version of the file if available. * | |
SassFile:: |
public static | function | * Returns the full path to a file to parse. * The file is looked for recursively under the load_paths directories and * the template_location directory. * If the filename does not end in .sass or .scss try the current syntax first * then, if a… | |
SassFile:: |
public static | function | * Returns the parse tree for a file. * If caching is enabled a cached version will be used if possible; if not the * parsed file will be cached. * | |
SassFile:: |
constant | |||
SassFile:: |
constant | |||
SassFile:: |
constant | |||
SassFile:: |
public static | function | * Saves a cached version of the file. * |