README

CoffeeScript 编译器到 PHP 的移植。

状态

CoffeeScript 版本 1.3.1 已完全移植（见标签）。移植的编译代码与参考代码之间有一些良性差异（例如 #11），除此之外它们匹配 100%。

要求

PHP 5.3+（使用命名空间，匿名函数）。

安装

建议使用 Composer 安装和自动加载 CoffeeScript。另外，您可以手动加载它

<?php

require 'vendor/CoffeeScript/Init.php';

// Load manually
CoffeeScript\Init::load();

?>

使用方法

API 非常基础（单个 compile($coffee, $options = NULL) 函数）。我不打算进一步扩展它（保持简单）。以下是可用的选项

filename - 源文件名，格式化为错误消息
header - 添加 "由...生成" 标头
bare - 如果设置为 true，生成的 JavaScript 不会嵌入到 IIFE
rewrite - 启用重写器（调试）
tokens - 引用令牌流（调试）
trace - 写解析跟踪的文件（调试）

<?php

$file = 'path/to/source.coffee';

try
{
  $coffee = file_get_contents($file);

  // See available options above.
  $js = CoffeeScript\Compiler::compile($coffee, array('filename' => $file));
}
catch (Exception $e)
{
  echo $e->getMessage();
}

?>

开发

要重建解析器，请运行 php make.php。测试在浏览器中运行；只需将仓库克隆到 Apache 可以看到的地方，然后导航到 tests/。

常见问题解答

这个项目的动力是什么？

当时我大量使用 PHP，并想使用、了解更多关于 CoffeeScript 项目，并可能为其做出贡献。我认为有一个原生版本会很好，所以我试了一下。

为什么不修改原始编译器以生成 PHP 代码？

出于许多原因……首先，我不知道为什么你需要这样。如果你觉得 PHP 无法忍受，那就不要使用它……其次，原始编译器依赖于 Jison，它是用 JavaScript 编写的，所以你必须处理这个问题。第三，我认为尝试解决 JavaScript 和 PHP 之间所有差异（对象模型、核心类和库等）将是一项艰巨的工作。

你使用什么解析器生成器？

由于没有Bison的PHP端口（参考编译器使用的端口），我们使用了名为的Lemon端口。

它是本地包含的，因为PEAR包未维护且似乎已损坏。此外，还对解析器模板（Lempar.php）和实际生成器进行了一些小的修改。

coffeescript / coffeescript

维护者

详细信息