PHPackages panique/php-sass - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Templating & Views](/categories/templating) 4. / 5. panique/php-sass ActiveLibrary[Templating & Views](/categories/templating) panique/php-sass ================ Compiles your SASS .scss files to .css every time your run your app (in development) v1.0(11y ago)12280.0k↑12.5%29[2 issues](https://github.com/panique/php-sass/issues)[4 PRs](https://github.com/panique/php-sass/pulls)MITPHPPHP >=5.3.0 Since Sep 8Pushed 7y ago11 watchersCompare [ Source](https://github.com/panique/php-sass)[ Packagist](https://packagist.org/packages/panique/php-sass)[ Docs](https://github.com/panique/php-sass)[ RSS](/packages/panique-php-sass/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (1)Dependencies (1)Versions (2)Used By (0) php-sass ======== [](#php-sass) Automatic SASS-to-CSS compiling (while being in development, you'll for sure not do this in production). Every time you run your app (hitting index.php for example) php-sass will automatically compile all .scss files in your scss folder to .css files in your css folder. Supports 3.2 version features of SASS (scss syntax) and mixins. Boom! You can also use Compass, but you'll add an older version of Compass's files (as the latest Compass is for SASS 3.3, not 3.2) to your scss folder manually. Installation & Usage ------------------------ [](#installation--usage) In your project's composer.json, add these dependencies. If you are not using Composer, then go into the corner and be very very very ashamed of yourself. And then, after standing there for 2-3 hours, watch some tutorials on how to use Composer, it's super-easy and a common minimum-standard in PHP development these days. Please note that this is a **require-dev**, not a normal **require**. This divides real dependencies from ones you only need for local development. ``` "require-dev": { "panique/php-sass": "1.0" } ``` Install or update your Composer dependencies to add php-sass by doing `composer install` or `composer update`. Composer automatically installs everything in require-dev by default. **IMPORTANT:** When you later deploy your application and don't want to install the require-dev stuff, then do `composer install --no-dev` (or `composer update --no-dev`). In your application, add this line into your `index.php` (or wherever you want to compile SASS to CSS). If you use this inside common frameworks, make sure you add this **before** the final application call, so in Laravel add it before `$app->run();` (some frameworks do stuff like `exit();` or caching, so the SASS compiler would never be called). ``` SassCompiler::run("scss/", "css/"); ``` The first parameter is the *relative* path to your scss folder (create one) and the second parameter is the *relative*path to your css folder. Make sure PHP can write into the css folder. For local development, a hardcore `sudo chmod -R 777 public/css` (when being in /var/www) is totally okay (remember, SASS compiling only happens locally, for production you'll deploy compiled .css files for sure). To use the very latest features of SASS: ---------------------------------------- [](#to-use-the-very-latest-features-of-sass) Currently php-sass fetches v0.1.1 (August 2014) of *leafo/scssphp* as a compiler. For latest features you might want a newer version, so have a look here and edit the composer.json accordingly. \[optional\] Good way to use it only in development, not on production ---------------------------------------------------------------------- [](#optional-good-way-to-use-it-only-in-development-not-on-production) To prevent using the SASS compiler in production, use an environment switch. Nearly all framework have something like this (google for "YOURFRAMEWORK environment"). For native usage: In your Apache vhost config, add a SetEnv variable, depending on what the server is (development, testing, production, etc): ``` ... SetEnv APPLICATION_ENV production ... ``` and in PHP ask for your environment like this: ``` if (getenv('APPLICATION_ENV') == 'development') { SassCompiler::run("scss/", "css/"); } ``` Optional features ----------------- [](#optional-features) There's an optional third parameter for `SassCompiler::run()` that expects one of the strings explained on [http://leafo.net/scssphp/docs/#output\_formatting](http://leafo.net/scssphp/docs/#output_formatting). This defines the desired output. `scss_formatter` is the standard laravel-sass uses, choose `scss_formatter_compressed` if you need a minimized css file. `scss_formatter_nested` is for nested output, optimized for readability. How @import works ----------------- [](#how-import-works) The `@import` of sass rules from other files works perfectly. Make sure to import the files like it should be: If the file is called \_colors.scss and is in the basic scss folder: ``` @import 'colors'; ``` If the file is called \_colors.scss and is in the subfolder `modules` of the basic scss folder: ``` @import 'modules/colors'; ``` Read the official docs for more. Used scripts ------------ [](#used-scripts) This tool uses the excellent [scssphp SASS compiler](http://leafo.net/scssphp/). scssphp supports the latest SCSS syntax (3.2.12). Other projects -------------- [](#other-projects) - - - - - My blog DEV METAL: License ------- [](#license) Licensed under [MIT](http://www.opensource.org/licenses/mit-license.php). Totally free for private or commercial projects. Support ------- [](#support) If you think this script is useful, then think about supporting the project by renting your next server at [Host1Plus](https://affiliates.host1plus.com/ref/devmetal/36f4d828.html) or [DigitalOcean](https://www.digitalocean.com/?refcode=40d978532a20). Thanks! ### Health Score 39 — LowBetter than 86% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity46 Moderate usage in the ecosystem Community16 Small or concentrated contributor base Maturity58 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 4270d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/b641f66783459f13c747fce81dec80456fa664ffde75f2bb09fd0e93f59165a4?d=identicon)[panique](/maintainers/panique) --- Top Contributors [![panique](https://avatars.githubusercontent.com/u/156321?v=4)](https://github.com/panique "panique (9 commits)") --- Tags csssassscss ### Embed Badge ![Health badge](/badges/panique-php-sass/health.svg) ``` [![Health](https://phpackages.com/badges/panique-php-sass/health.svg)](https://phpackages.com/packages/panique-php-sass) ``` ### Alternatives [zurb/foundation The most advanced responsive front-end framework in the world. 29.8k380.2k15](/packages/zurb-foundation)[scssphp/scssphp scssphp is a compiler for SCSS written in PHP. 62827.7M220](/packages/scssphp-scssphp)[panique/laravel-sass Compiles your Sass .scss files to .css every time you run your app (in development) 73171.8k1](/packages/panique-laravel-sass)[trentrichardson/cakephp-shrink Compiles, combines, and minifies javascript, coffee, less, scss, and css 1619.3k](/packages/trentrichardson-cakephp-shrink) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)