README

PhpExecJS 允许您从PHP运行JavaScript代码。

简例

print_r($phpexecjs->evalJs("'red yellow blue'.split(' ')"));

将打印

Array
(
    [0] => red
    [1] => yellow
    [2] => blue
)

安装

composer require nacmartin/phpexecjs

示例程序

用法

<?php
    require __DIR__ . '/../vendor/autoload.php';
    
    use Nacmartin\PhpExecJs\PhpExecJs;
    
    $phpexecjs = new PhpExecJs();
    
    print_r($phpexecjs->evalJs("'red yellow blue'.split(' ')"));

将打印

Array
(
    [0] => red
    [1] => yellow
    [2] => blue
)

使用上下文

您可以设置一个上下文，例如库和其他一些您想在您的eval'd代码中使用的项目。例如，ReactBundle使用此功能在服务器端渲染React。

例如，我们可以使用此功能编译CoffeeScript

    $phpexecjs->createContextFromFile("https://coffeescript.node.org.cn/extras/coffee-script.js");
    print_r($phpexecjs->call("CoffeeScript.compile", ["square = (x) -> x * x", ['bare' => true]]));


That will print:

      var square;
    
      square = function(x) {
        return x * x;
      };

您可以将此示例扩展到像使用此函数作为上下文这样的功能

    $square = $phpexecjs->call("CoffeeScript.compile", ["square = (x) -> x * x", ['bare' => true]]);
    $phpexecjs->createContext($square);
    print_r($phpexecjs->evalJs('square(3)'));

这将打印 9。

这可以用于，例如，使用CoffeeScript或编译JavaScript模板语言中的模板。

它是如何工作的

当您运行 evalJs 时，代码将被插入到一个小包装器中，该包装器用于运行JavaScript的 eval() 并检查错误处理状态。

如果您设置了上下文，则代码将在JavaScript中调用 eval() 之前插入，并且如果您安装了 V8Js 扩展，它将预编译它。

支持的运行时

默认情况下，PhPExecjs 将自动检测可用的最佳运行时。目前支持的例程有

• V8Js (PHP扩展)
• node.js

建议安装V8Js，但您可能希望在生产环境中安装它，同时在开发期间仍然能够使用PhpExecJs调用子进程作为node，这样您就不需要安装扩展。

添加外部运行时

如果您有一个外部运行器（例如，Spidermonkey），并且您想使用它，将其传递给构造函数

    $myRuntime = new ExternalRuntime('My runtime name', 'my_command');
    $phpExecJs = new PhpExecJs($myRuntime);

与运行时合作

我们希望支持更多的运行时（例如，Duktape）。如果您想为运行时做出贡献，这非常简单。您只需要实现 src/Runtimes/RuntimeInterface。查看 src/Runtimes 目录以获取示例。

为什么我不能使用像 setTimeout 这样的某些函数？

PhpExecJs 为JavaScript运行时提供了一个通用的接口，因此它只能运行与解释器无关的代码。因此，一些功能被禁用。值得注意的是，定时器功能被禁用，因为并非所有运行时都保证完整的JavaScript事件循环。如果您想使用这些功能之一，请直接使用node.js而不是这个更高级的库

global、module、exports、require、console、setTimeout、setInterval、clearTimeout、clearInterval、setImmediate、clearImmediate

鸣谢

此库受到了ExecJs，一个Ruby库的启发。

用于管理进程和临时文件的代码已从KNPLabs的Snappy库中改编。