ExecJs

Requirements

• PHP 7.0+
• V8Js extension 2.0+

Installation

composer require chenos/execjs

Testing

make test

Example

make example

Access http://127.0.0.1:9999

• liquidjs
• marked & markdown-it
• react
• vue-simple
• vue-router
• js-yaml

Usage

useChenos\ExecJs\Context;
useChenos\V8JsModuleLoader\ModuleLoader;
$context = newContext('PHP');
$context->getLoader()
->setEntryDir(__DIR__)
->addVendorDir(__DIR__.'/node_modules')
->addOverride('vue', 'vue/dist/vue.runtime.common.js')
;
// or$loader = newModuleLoader();
$loader->setEntryDir(__DIR__)
->addVendorDir(__DIR__.'/node_modules')
->addOverride('vue', 'vue/dist/vue.runtime.common.js')
;
$context->setLoader($loader);
$context->eval(string $script);
$context->load(string $module);
$context->require($module, string|array $identifier);
$context->set(string $key, mixed $value, $global = false);

API

eval

Evaluates JavaScript code represented as a string.

public mixed function eval(string$script, int$flags = V8Js::FLAG_NONE, int$timeLimit = 0, int$memoryLimit = 0)

Almost the same as V8Js::executeString except $identifier argument.

public mixed function V8Js::executeString(string$script, string$identifier = '', int$flags = V8Js::FLAG_NONE, int$timeLimit = 0, int$memoryLimit = 0)

Usage:

$context->eval('1+1'); // 2

load

Evaluates JavaScript code represented from a file.

public mixed function load(string$module, int$flags = V8Js::FLAG_NONE, int$timeLimit = 0, int$memoryLimit = 0)

$context->load('./foo.js');
// equals$str = $context->getLoader()->loadModule('./foo.js');
$context->eval($str);

require

CommonJS module support to require external code.

public mixed function require(string$module, string|array$identifier = null)

Usage:

$yaml = $context->require('js-yaml');
$yaml->load('a: b'); // ['a' => 'b']

String identifier

$yaml = $context->require('js-yaml', 'jsyaml');
// equals$context->eval("var jsyaml = require('js-yaml'); jsyaml;");
// usage$yaml->load('a: b'); // ['a' => 'b']$context->eval(sprintf('jsyaml.dump(%s)', json_encode(['a' => 'b']))); // 'a: b'

Array identifier

$context->require('js-yaml', ['load', 'dump']);
// equals$context->eval("var {load, dump} = require('js-yaml').load;");
$context->eval("load('a: b')"); // ['a' => 'b']$context->eval(sprintf('dump(%s)', json_encode(['a' => 'b']))); // 'a: b'$context->require('js-yaml', ['load' => 'yamlLoad']);
// equals$context->eval("var yamlLoad = require('js-yaml').load;");
// es6: import {load as yamlLoad} from 'js-yaml'$context->eval("yamlLoad('a: b')"); // ['a' => 'b']

set

Assign a property to make it accessible to the javascript context.

public Context function set(string$key, mixed$value, $global = false)

Usage:

$context->set('foo', 'bar');
$context->eval('PHP.foo'); // bar$context->eval('foo'); // error undefined$context->set('bar', 'baz', true);
$context->eval('PHP.bar'); // baz$context->eval('bar'); // baz$context->set('process', [
'env' => [
'NODE_ENV' => 'production',
],
], true);
$context->eval('process.env.NODE_ENV'); // production

Global Variables

• exit V8Function
• PHP V8Js
• print V8Function
• require V8Function
• sleep V8Function
• var_dump V8Function