Skip to content

Latest commit

 

History

History
154 lines (111 loc) · 5.54 KB

index.md

File metadata and controls

154 lines (111 loc) · 5.54 KB
Raw

scssphp is a compiler for SCSS written in PHP.

SCSS is a CSS preprocessor that adds many features like variables, mixins, imports, color manipulation, functions, and tons of other powerful features.

The entire compiler comes in a single class file ready for including in any kind of project in addition to a command line tool for running the compiler from the terminal.

scssphp implements SCSS (3.2.7). It does not implement the SASS syntax, only the SCSS syntax.

Follow the author on twitter: @moonscript.

<iframe src="http://ghbtns.com/github-btn.html?user=leafo&repo=scssphp&type=watch&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="110px" height="20px"></iframe> <iframe src="http://ghbtns.com/github-btn.html?user=leafo&repo=scssphp&type=fork&count=true" allowtransparency="true" frameborder="0" scrolling="0" width="95px" height="20px"></iframe>

Installing

You can always download the latest version here:
scssphp-$current_version.tar.gz

You can also find the latest source online:
https://github.com/leafo/scssphp/

If you use Packagist for installing packages, then you can update your composer.json like so:

$render{[[composer]]}

Language Reference

For a complete guide to the syntax of SCSS, consult the official documentation.

PHP Reference

Complete documentation for scssphp is located at http://leafo.net/scssphp/docs/.

Quickstart

If you just want to start serving compiled scss files as quick as possible then start here.

scssphp comes with a easy to use class that automatically compiles modified scss files and serves them from a directory you specify.

Create a file, like style.php:

```php
<?php
$directory = "stylesheets";

require "scssphp/scss.inc.php";
scss_server::serveFrom($directory);

```

Create the directory set in the script alongside the script, then add your scss files to it.

If we've got a file in there called style.scss, then we just need to hit the url: example.com/style.php/style.scss to get the compiled css.

If there is an error compiling, the url will result in a 500 error with the error message. If the file can't be found, then a friendly 404 is returned.

scssphp will automatically create a scss_cache directory inside the stylesheets directory where it will cache the compiled output. This way it can quickly serve the files if no modifications have been made. Your PHP script must have permission to write in scss_cache.

Compiler Interface

If you're interested in directly using the compiler, then all you need to do is require scss.inc.php and invoke the scss class:

```php
<?php
require "scssphp/scss.inc.php";
$scss = new scssc();

echo $scss->compile('
  $color: #abc;
  div { color: lighten($color, 20%); }
');

```

The compile method takes SCSS as a string, and returns the CSS. If there is an error when compiling then an exception is thrown with an appropriate message.

For a more detailed guide consult http://leafo.net/scssphp/docs/.

Issues

Find any issues? I'd love to fix them for you, post about them on the issues tracker.

Changelog

  • 0.0.5 -- March 11, 2013
    • Better compile time errors
    • Fix top level properties inside of a nested @media (Anthon Pang)
    • Fix some issues with @extends (Anthon Pang)
    • Enhanced handling of null (Anthon Pang)
    • Helper functions shouldn't mix with css builtins (Anthon Pang)
    • Enhace selector parsing (Guilherme Blanco, Anthon Pang)
    • Add Placeholder selector support (Martin Hasoň)
    • Add variable argument support (Martin Hasoň)
    • Add zip, index, comparable functions (Martin Hasoň)
    • A bunch of parser and bug fixes
  • 0.0.4 -- Import path can be a function (Christian Lück). Correctly parse media queries with more than one item (Christian Lück). Add ie_hex_str, abs, min, max functions (Martin Hasoň), ignore expressions inside of calc() (Martin Hasoň), Improve operator evaluation (Martin Hasoň), Add @content support. Misc bug fixes. (Nov 3nd, 2012)
  • 0.0.3 -- Add missing and/or/not operators. Expression evaluation happens correctly. Import file caching and _partial filename support. Misc bug fixes. (August 2nd, 2012)
  • 0.0.2 -- SCSS server is aware of imports, added custom function interface, compressed formatter, documentation (July 30th, 2012)
  • Initial Release v0.0.1 (July 29th, 2012)

Comments

<script type="text/javascript"> var disqus_shortname = 'leafo'; var disqus_url = 'http://leafo.net/scssphp/';

(function() { var dsq = document.createElement('script'); dsq.type = 'text/javascript'; dsq.async = true; dsq.src = 'http://' + disqus_shortname + '.disqus.com/embed.js'; (document.getElementsByTagName('head')0 || document.getElementsByTagName('body')0).appendChild(dsq); })(); </script>