2012-04-27 16:28:54 +00:00
|
|
|
V8Js
|
|
|
|
====
|
|
|
|
|
|
|
|
This is a PHP extension for Google's V8 Javascript engine
|
|
|
|
|
|
|
|
|
|
|
|
Minimum requirements
|
|
|
|
--------------------
|
|
|
|
|
2012-04-27 16:47:52 +00:00
|
|
|
- V8 JavaScript Engine library version 2.5.8 <http://code.google.com/p/v8/> (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, and runs on Windows (XP or newer),
|
|
|
|
Mac OS X (10.5 or newer), and Linux systems that use IA-32, x64, or ARM processors.
|
|
|
|
V8 can run standalone, or can be embedded into any C++ application.
|
|
|
|
You can find more information here:
|
|
|
|
<http://code.google.com/p/v8/>
|
2012-04-27 16:28:54 +00:00
|
|
|
|
|
|
|
- PHP 5.3.3+ (non-ZTS build preferred)
|
|
|
|
Note: V8 engine is not natively thread safe and this extension
|
|
|
|
has not been designed to work around it either yet and might or
|
|
|
|
might not work properly with ZTS enabled PHP. :)
|
|
|
|
|
|
|
|
|
|
|
|
API
|
|
|
|
===
|
|
|
|
|
2012-07-24 12:03:32 +00:00
|
|
|
class V8Js
|
|
|
|
{
|
|
|
|
/* Constants */
|
|
|
|
|
|
|
|
const string V8_VERSION;
|
|
|
|
const int FLAG_NONE;
|
|
|
|
const int FLAG_FORCE_ARRAY;
|
|
|
|
|
|
|
|
/* Methods */
|
|
|
|
|
|
|
|
// Initializes and starts V8 engine and Returns new V8Js object with it's own V8 context.
|
|
|
|
public __construct ( [string object_name = "PHP" [, array variables = NULL [, array extensions = NULL [, bool report_uncaught_exceptions = TRUE]]] )
|
|
|
|
|
|
|
|
// Compiles and executes script in object's context with optional identifier string.
|
|
|
|
public mixed V8Js::executeString( string script [, string identifier [, int flags = V8Js::FLAG_NONE]])
|
|
|
|
|
|
|
|
// Returns uncaught pending exception or null if there is no pending exception.
|
2013-04-13 23:36:31 +00:00
|
|
|
public V8JsScriptException V8Js::getPendingException( void )
|
2012-07-24 12:03:32 +00:00
|
|
|
|
|
|
|
/** 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!
|
|
|
|
public static bool V8Js::registerExtension(string ext_name, string script [, array deps [, bool auto_enable = FALSE]])
|
|
|
|
|
|
|
|
// Returns extensions successfully registered with V8Js::registerExtension().
|
|
|
|
public static array V8Js::getExtensions( void )
|
|
|
|
}
|
|
|
|
|
2013-04-13 23:36:31 +00:00
|
|
|
final class V8JsScriptException extends Exception
|
2012-07-24 12:03:32 +00:00
|
|
|
{
|
|
|
|
/* Properties */
|
|
|
|
protected string JsFileName = NULL;
|
|
|
|
protected int JsLineNumber = NULL;
|
|
|
|
protected string JsSourceLine = NULL;
|
|
|
|
protected string JsTrace = NULL;
|
|
|
|
|
|
|
|
/* Methods */
|
|
|
|
final public string getJsFileName( void )
|
|
|
|
final public int getJsLineNumber( void )
|
|
|
|
final public string getJsSourceLine( void )
|
|
|
|
final public string getJsTrace( void )
|
|
|
|
}
|
|
|
|
|
|
|
|
|