absalomedia/sasshhvm

sasshhvm

absalomedia/sasshhvm镜像提供了适用于https://github.com/***/hhvm%E7%9A%84%60sass%60%E6%89%A9%E5%B1%95%EF%BC%8C%E5%85%81%E8%AE%B8%E6%82%A8%E5%9C%A8PHP%E5%BA%94%E7%94%A8%E4%B8%AD%E9%80%9A%E8%BF%87%E9%9D%A2%E5%90%91%E5%AF%B9%E8%B1%A1%E7%9A%84%E6%96%B9%E5%BC%8F%E8%A7%A3%E6%9E%90Sass%E3%80%82%E5%85%B6%E5%BA%95%E5%B1%82%E4%BD%BF%E7%94%A8https://github.com/sass/libsass%EF%BC%88%E4%B8%80%E4%B8%AA%E6%97%A0%E9%9C%80Ruby%E7%9A%84C%E8%AF%AD%E8%A8%80%E5%BA%93%EF%BC%89%E6%9D%A5%E8%A7%A3%E6%9E%90%E5%92%8C%E7%BC%96%E8%AF%91sass/scss%E6%96%87%E4%BB%B6%EF%BC%8C%E5%9F%BA%E4%BA%8Ehttps://github.com/sensational/sassphp%E5%BC%80%E5%8F%91%E3%80%82

!https://img.shields.io/badge/libsass-3.4.8-yellow.svg https://travis-ci.org/absalomedia/sasshhvm.svg](https://travis-ci.org/absalomedia/sasshhvm)

什么是Sass？

Sass是一种CSS预处理器语言，为CSS添加了丰富的扩展功能。它是同类语言中最早且最成熟的代码库。Sass最初由Ha***on Catlin创建，后续由Natalie Weizenbaum和Chris Eppstein持续演进。更多信息请访问Sass官网。

构建与安装

需要HHVM 3.2或更高版本，以及HHVM源代码树（通过$HPHP_HOME变量指定路径）或https://github.com/***/hhvm/wiki/Prebuilt-Packages-for-HHVM%E3%80%82

更新子模块：

bash
git submodule update --init --recursive

然后运行：

bash
./build.sh

启用扩展需在PHP配置文件中添加以下内容：

ini
hhvm.dynamic_extension_path = /path/to/hhvm/extensions
hhvm.dynamic_extensions[sass] = sass.so

其中/path/to/hhvm/extensions是存放HHVM扩展的目录，sass.so需位于该目录中。

测试

运行测试套件：

bash
cd /path/to/extension
./test.sh

若有完整HHVM源代码树，可通过以下命令运行测试：

bash
HPHP_HOME=/path/to/hhvm/source ./test.sh

使用方法

该扩展提供简洁的API：

1. 编译Sass源码：

php
$sass = new Sass();
$css = $sass->compile($source);

2. 编译文件：

php
$sass = new Sass();
$css = $sass->compileFile($source);
// 别名：$css = $sass->compile_file($source);

3. 设置包含路径：

php
$sass = new Sass();
$sass->setIncludePath('/tmp');
$css = $sass->compile($source);

4. 设置输出样式：

php
$sass = new Sass();
$sass->setStyle(Sass::STYLE_NESTED); // 嵌套样式
$sass->setStyle(Sass::STYLE_EXPANDED); // 扩展样式
$sass->setStyle(Sass::STYLE_COMPACT); // 紧凑样式
$sass->setStyle(Sass::STYLE_COMPRESSED); // 压缩样式

5. 生成源注释：

php
$sass = new Sass();
$sass->setComments(true);
$css = $sass->compileFile($source);

6. 启用缩进语法（SASS而非SCSS）：

php
$sass = new Sass();
$sass->setIndent(true);
$css = $sass->compile($source);

7. 嵌入源映射：

php
$sass = new Sass();
$sass->setEmbed(true);
$css = $sass->compile($source);

8. 生成源映射文件：

php
$sass = new Sass();
$sass->setMapPath('/random.output.css.map');
$css = $sass->compileFile($source);
// $css[0]为编译后的CSS，$css[1]为源映射内容

9. 设置源映射根目录：

php
$sass = new Sass();
$sass->setMapRoot('/some/dir');
$sass->setMapPath('/random.output.css.map');
$css = $sass->compileFile($source);

10. 异常处理：

php
$sass = new Sass();
try {
    $css = $sass->compile('invalid-sass-code');
} catch (SassException $e) {
    // 处理错误：$e->getMessage()
    $css = false;
}