V8引擎的PHP扩展v8js.zip

V8Js ==== [](https://travis-ci.org/phpv8/v8js) [](https://raw.githubusercontent.com/phpv8/v8js/master/LICENSE) [](https://gitter.im/phpv8/v8js?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) V8Js is a PHP extension for Google's V8 Javascript engine. The extension allows you to execute Javascript code in a secure sandbox from PHP. The executed code can be restricted using a time limit and/or memory limit. This provides the possibility to execute untrusted code with confidence. If you execute untrusted JavaScript code, make sure to **use V8 version 6.4.388.18, 6.5.143 or higher**. See notes on [untrusted code mitigations](https://github.com/v8/v8/wiki/Untrusted-code-mitigations) for further details. Minimum requirements -------------------- - V8 Javascript Engine library (libv8) master <https://github.com/v8/v8-git-mirror> (trunk) V8 is Google's open source Javascript engine. V8 is written in C++ and is used in Google Chrome, the open source browser from Google. V8 implements ECMAScript as specified in ECMA-262, 5th edition. This extension requires V8 6.9 (6.9.427.18 is known to work) or higher. V8 releases are published rather quickly and the V8 team usually provides security support for the version line shipped with the Chrome browser (stable channel) and newer (only). For a version overview see https://omahaproxy.appspot.com/. - PHP 7.0.0+ This embedded implementation of the V8 engine uses thread locking so it works with ZTS enabled. Windows is currently *not* officially supported. Mostly since I don't have the time to maintain support for it myself, and don't really have Windows boxes to try things with. It would be great if someone could step up and fix things on Windows, provide pre-build V8 binaries, etc. Pre-built binaries ------------------ For some very first steps, instead of compiling manually you might want to try out the [V8Js docker image](https://registry.hub.docker.com/u/stesie/v8js/). It has v8, v8js and php-cli pre-installed so you can give it a try with PHP in "interactive mode". There is no Apache, etc. running however. For Ubuntu @stesie has a PPA, based on prior work by @pinepain. [See here](https://launchpad.net/~stesie/+archive/ubuntu/libv8/), packaging sources are available [from ppa-packaging repository](https://github.com/phpv8/ppa-packaging/tree/stesie/) (*stesie* branch). You might want to install these and compile V8Js based on them. There also is a Heroku extension pack that has recent V8Js versions for PHP 7.x, see [@stesie's blog post](https://stesie.github.io/2016/03/heroku-custom-platform-repo) for details. Compiling latest version ------------------------ Building on Microsoft Windows is a bit more involved, see README.Win32.md file for a quick run through. Building on GNU/Linux and MacOS X is straight forward, see README.Linux.md and README.MacOS.md files for a walk through with platform specific notes. PHP API ======= ```php <?php class V8Js { /* Constants */ const V8_VERSION = ''; const FLAG_NONE = 1; const FLAG_FORCE_ARRAY = 2; const FLAG_PROPAGATE_PHP_EXCEPTIONS = 4; /* Methods */ /** * Initializes and starts V8 engine and returns new V8Js object with it's own V8 context. * @param string $object_name * @param array $variables * @param array $extensions * @param bool $report_uncaught_exceptions * @param string $snapshot_blob */ public function __construct($object_name = "PHP", array $variables = [], array $extensions = [], $report_uncaught_exceptions = TRUE, $snapshot_blob = NULL) {} /** * Provide a function or method to be used to load required modules. This can be any valid PHP callable. * The loader function will receive the normalised module path and should return Javascript code to be executed. * @param callable $loader */ public function setModuleLoader(callable $loader) {} /** * Provide a function or method to be used to normalise module paths. This can be any valid PHP callable. * This can be used in combination with setModuleLoader to influence normalisation of the module path (which * is normally done by V8Js itself but can be overriden this way). * The normaliser function will receive the base path of the current module (if any; otherwise an empty string) * and the literate string provided to the require method and should return an array of two strings (the new * module base path as well as the normalised name). Both are joined by a '/' and then passed on to the * module loader (unless the module was cached before). * @param callable $normaliser */ public function setModuleNormaliser(callable $normaliser) {} /** * Compiles and executes script in object's context with optional identifier string. * A time limit (milliseconds) and/or memory limit (bytes) can be provided to restrict execution. These options will throw a V8JsTimeLimitException or V8JsMemoryLimitException. * @param string $script * @param string $identifier * @param int $flags * @param int $time_limit in milliseconds * @param int $memory_limit in bytes * @return mixed */ public function executeString($script, $identifier = '', $flags = V8Js::FLAG_NONE, $time_limit = 0, $memory_limit = 0) {} /** * Compiles a script in object's context with optional identifier string. * @param $script * @param string $identifier * @return resource */ public function compileString($script, $identifier = '') {} /** * Executes a precompiled script in object's context. * A time limit (milliseconds) and/or memory limit (bytes) can be provided to restrict execution. These options will throw a V8JsTimeLimitException or V8JsMemoryLimitException. * @param resource $script * @param int $flags * @param int $time_limit * @param int $memory_limit */ public function executeScript($script, $flags = V8Js::FLAG_NONE, $time_limit = 0 , $memory_limit = 0) {} /** * Set the time limit (in milliseconds) for this V8Js object * works similar to the set_time_limit php * @param int $limit */ public function setTimeLimit($limit) {} /** * Set the memory limit (in bytes) for this V8Js object * @param int $limit */ public function setMemoryLimit($limit) {} /** * Set the average object size (in bytes) for this V8Js object. * V8's "amount of external memory" is adjusted by this value for every exported object. V8 triggers a garbage collection once this totals to 192 MB. * @param int $average_object_size */ public function setAverageObjectSize($average_object_size) {} /** * Returns uncaught pending exception or null if there is no pending exception. * @return V8JsScriptException|null */ public function getPendingException() {} /** * Clears the uncaught pending exception */ public function clearPendingException() {} /** Static methods **/ /** * Registers persistent context independent global Javascript extension. * NOTE! These extensions exist until PHP is shutdown and they need to be registered before V8 is initialized. * For best performance V8 is initialized only once per process thus this call has to be done before any V8Js objects are created! * @param string $extension_name * @param string $code * @param array $dependencies * @param bool $auto_enable * @return bool */ public static function registerExtension($extension_name, $code, array $dependencies, $auto_enable = FALSE) {} /*