PHPackages                             elephfront/robo-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. elephfront/robo-sass

ActiveRobo-tasks

elephfront/robo-sass
====================

Robo task to perform SASS files compilation to CSS files.

1.0.2(8y ago)0421MITPHPPHP >=7.1.0

Since Aug 3Pushed 8y ago1 watchersCompare

[ Source](https://github.com/elephfront/robo-sass)[ Packagist](https://packagist.org/packages/elephfront/robo-sass)[ RSS](/packages/elephfront-robo-sass/feed)WikiDiscussions master Synced yesterday

READMEChangelog (3)Dependencies (2)Versions (4)Used By (1)

Robo Sass
=========

[](#robo-sass)

[![Software License](https://camo.githubusercontent.com/9a66612deb245a997157ce51e09a457827107c9cd9a9ee14c908c16fe9ee6f7f/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f6272616e63683d6d6173746572)](LICENSE.txt)[![Build Status](https://camo.githubusercontent.com/f2803867c51043d92130aa60063dc13f17bee03f249d7cc61a038a60e3adbf42/68747470733a2f2f7472617669732d63692e6f72672f656c65706866726f6e742f726f626f2d736173732e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/elephfront/robo-sass)[![Codecov](https://camo.githubusercontent.com/1a90d52b8e6da8839361175669cc28563fbe7378e7d5571802a795eda596501a/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f656c65706866726f6e742f726f626f2d736173732e737667)](https://github.com/elephfront/robo-sass)

This [Robo](https://github.com/consolidation/robo) task performs a compilation of your SASS files.

This task performs the compilation using the [absalomedia/sassphp](https://github.com/absalomedia/sassphp) PHP extension.

Requirements
------------

[](#requirements)

- PHP >= 7.1.0
- Robo
- The [absalomedia/sassphp](https://github.com/absalomedia/sassphp) PHP extension.

Installation
------------

[](#installation)

You can install this Robo task using [composer](http://getcomposer.org).

The recommended way to install composer packages is:

```
composer require elephfront/robo-sass

```

Installing the extension
------------------------

[](#installing-the-extension)

To install the extension, you need to follow the steps below :

```
git clone git://github.com/absalomedia/sassphp`
cd sassphp
git submodule init
git submodule update
php install.php
make test
make install

```

Once the extension has been installed, you need to update your php.ini (or add a new configuration file your php.ini goes looking in to load extra configuration setup) file to install the extension on your PHP setup by adding the following line :

```
extension=sass.so

```

Using the task
--------------

[](#using-the-task)

You can load the task in your RoboFile using the `LoadSassTaskTrait` trait:

```
use Elephfront\RoboSass\Task\Loader\LoadSassTaskTrait;

class RoboFile extends Tasks
{

    use LoadSassTaskTrait;

    public function compileSass()
    {
        $this
            ->taskSass([
                'assets/scss/main.scss' => 'assets/min/css/main.min.css',
                'assets/scss/home.scss' => 'assets/min/css/home.min.css',
            ])
            ->run();
    }
}
```

The only argument the `taskSass()` takes is an array (`$destinationsMap`) which maps the source files to the destination files : it will load the **assets/scss/main.scss**, do its magic and put the final content in **assets/min/css/main.min.css** and do the same for all of the other files.

Chained State support
---------------------

[](#chained-state-support)

Robo includes a concept called the [Chained State](http://robo.li/collections/#chained-state) that allows tasks that need to work together to be executed in a sequence and pass the state of the execution of a task to the next one. For instance, if you are managing assets files, you will have a task that compile SCSS to CSS then another one that minify the results. The first task can pass the state of its work to the next one, without having to call both methods in a separate sequence.

The **robo-sass** task is compatible with this feature.

All you need to do is make the previous task return the content the **robo-sass** task should operate on using the `data` argument of a `Robo\Result::success()` or `Robo\Result::error()` call. The passed `data` should have the following format:

```
$data = [
    'path/to/source/file' => [
        'css' => '// Some (S)CSS code',
        'destination' => 'path/to/destination/file
    ]
];
```

In turn, when the **robo-sass** task is done, it will pass the results of its work to the next task following the same format.

Preventing the results from being written
-----------------------------------------

[](#preventing-the-results-from-being-written)

By default, the **robo-sass** task writes the result of its work into the destination file(s) passed in the `$destinationsMap` argument. If the **robo-sass** task is not the last one in the sequence, you can disable the file writing using the `disableWriteFile()` method. The files will be processed but the results will not be persisted and only passed to the response :

```
$this
    ->taskCssMinify([
        'assets/scss/main.css' => 'assets/min/css/main.min.css',
        'assets/scss/home.css' => 'assets/min/css/home.min.css',
    ])
        ->disableWriteFile()
    ->someOtherTask()
    ->run();
```

Contributing
------------

[](#contributing)

If you find a bug or would like to ask for a feature, please use the [GitHub issue tracker](https://github.com/Elephfront/robo-sass/issues). If you would like to submit a fix or a feature, please fork the repository and [submit a pull request](https://github.com/Elephfront/robo-sass/pulls).

### Coding standards

[](#coding-standards)

This repository follows the PSR-2 standard.

License
-------

[](#license)

Copyright (c) 2017, Yves Piquel and licensed under [The MIT License](http://opensource.org/licenses/mit-license.php). Please refer to the LICENSE.txt file.

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity60

Established project with proven stability

 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

Every ~2 days

Total

3

Last Release

3199d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/c7ade5318f46ea6ffa30a140639a71bb9f078f8322efc24268d0f94cd7c4deee?d=identicon)[HavokInspiration](/maintainers/HavokInspiration)

---

Top Contributors

[![HavokInspiration](https://avatars.githubusercontent.com/u/5243386?v=4)](https://github.com/HavokInspiration "HavokInspiration (14 commits)")

---

Tags

elephfrontroborobo-tasksass-compilation

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/elephfront-robo-sass/health.svg)

```
[![Health](https://phpackages.com/badges/elephfront-robo-sass/health.svg)](https://phpackages.com/packages/elephfront-robo-sass)
```

###  Alternatives

[drush/drush

Drush is a command line shell and scripting interface for Drupal, a veritable Swiss Army knife designed to make life easier for those of us who spend some of our working hours hacking away at the command prompt.

2.4k57.4M685](/packages/drush-drush)[pantheon-systems/terminus

A command line interface for Pantheon

3391.5M13](/packages/pantheon-systems-terminus)[edgedesign/phpqa

Analyze PHP code with one command.

5641.0M24](/packages/edgedesign-phpqa)[codeception/robo-paracept

Codeception Parallel Execution Tasks via Robo Task Runner

583.6M1](/packages/codeception-robo-paracept)[chromatic/usher

A collection of Robo commands for use on Chromatic projects.

13534.3k1](/packages/chromatic-usher)[ec-europa/toolkit

Toolkit packaged for Drupal projects based on Robo.

38244.6k16](/packages/ec-europa-toolkit)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)