Adds File based source map (in addition to inline source map) - SOURCE_MAP_FILE, using code from less.php; ONLY if there is output from the scss file.

Author: dleffler

scss.inc.php

@@ -11,6 +11,7 @@
     include_once __DIR__ . '/src/Compiler/Environment.php';
     include_once __DIR__ . '/src/Exception/CompilerException.php';
     include_once __DIR__ . '/src/Exception/ParserException.php';
+    include_once __DIR__ . '/src/Exception/RangeException.php';  //exp
     include_once __DIR__ . '/src/Exception/ServerException.php';
     include_once __DIR__ . '/src/Formatter.php';
     include_once __DIR__ . '/src/Formatter/Compact.php';
@@ -23,6 +24,9 @@
     include_once __DIR__ . '/src/Node.php';
     include_once __DIR__ . '/src/Node/Number.php';
     include_once __DIR__ . '/src/Parser.php';
+//    include_once __DIR__ . '/src/example/Server.php';
+    include_once __DIR__ . '/src/SourceMap/Base64VLQEncoder.php';
+    include_once __DIR__ . '/src/SourceMap/SourceMapGenerator.php';
     include_once __DIR__ . '/src/Type.php';
     include_once __DIR__ . '/src/Util.php';
     include_once __DIR__ . '/src/Version.php';

src/Compiler.php

@@ -67,6 +67,7 @@ class Compiler
 
     const SOURCE_MAP_NONE = 0;
     const SOURCE_MAP_INLINE = 1;
+    const SOURCE_MAP_FILE = 2;
 
     /**
      * @var array
@@ -205,12 +206,14 @@ public function compile($code, $path = null)
             $sourceMapGenerator = new SourceMapGenerator($this->sourceMapOptions);
         }
         $out = $this->formatter->format($this->scope, $sourceMapGenerator);
-        if($this->sourceMap &&  $this->sourceMap !== self::SOURCE_MAP_NONE) {
+        if(!empty($out) && $this->sourceMap &&  $this->sourceMap !== self::SOURCE_MAP_NONE) {
             $sourceMap = $sourceMapGenerator->generateJson();
 
             $sourceMapUrl = null;
             if($this->sourceMap == self::SOURCE_MAP_INLINE) {
                 $sourceMapUrl = sprintf('data:application/json,%s', self::encodeURIComponent($sourceMap));
+            } elseif ($this->sourceMap == self::SOURCE_MAP_FILE) {
+                $sourceMapUrl = $sourceMapGenerator->saveMap($sourceMap);
             }
 
             $out .= sprintf('/*# sourceMappingURL=%s */', $sourceMapUrl);

src/SourceMap/SourceMapGenerator.php

@@ -8,6 +8,8 @@
 
 namespace Leafo\ScssPhp\SourceMap;
 
+use Leafo\ScssPhp\Exception\CompilerException;
+
 class SourceMapGenerator {
     /**
      * What version of source map does the generator generate?
@@ -94,6 +96,28 @@ public function addMapping($generatedLine, $generatedColumn, $originalLine, $ori
         $this->sources[$sourceFile] = $sourceFile;
     }
 
+    /**
+   	 * Saves the source map to a file
+   	 *
+   	 * @param string $file The absolute path to a file
+   	 * @param string $content The content to write
+   	 * @throws Exception If the file could not be saved
+   	 */
+   	public function saveMap($content){
+   	    $file = $this->options['sourceMapWriteTo'];
+   		$dir = dirname($file);
+   		// directory does not exist
+   		if( !is_dir($dir) ){
+   			// FIXME: create the dir automatically?
+   			throw new CompilerException(sprintf('The directory "%s" does not exist. Cannot save the source map.', $dir));
+   		}
+   		// FIXME: proper saving, with dir write check!
+   		if(file_put_contents($file, $content) === false){
+   			throw new CompilerException(sprintf('Cannot save the source map to "%s"', $file));
+   		}
+   		return $this->options['sourceMapURL'];
+   	}
+
     /**
      * Generates the JSON source map
      *