This extension is for PHP 7 only.
This extension is still under heavy development and its public API may change without any warning. Use at your own risk.
- accurate native V8 C++ API implementation available from PHP;
- solid experience between native V8 C++ API and V8 API in PHP;
- no magic; no assumptions;
- does what it is asked to do;
- hides complexity with isolates and contexts scope management under the hood;
- provides a both-way interaction with PHP and V8 objects, arrays and functions;
- execution time and memory limits;
- multiple isolates and contexts at the same time;
- it works;
With this extension almost everything that the native V8 C++ API provides can be used. It provides a way to pass PHP scalars, objects and functions to the V8 runtime and specify interactions with passed values (objects and functions only, as scalars become js scalars too). While specific functionality will be done in PHP userland rather than in this C/C++ extension, it lets you get into V8 hacking faster, reduces time costs and gives you a more maintainable solution. And it doesn't make any assumptions for you, so you stay in control, it does exactly what you ask it to do.
With php-v8 you can even implement nodejs in PHP. Not sure whether anyone should/will do this anyway, but it's doable.
NOTE: Most, if not all, methods are named like in the V8 API - starting from capital letter. This PSR violation is done intentionally with the purpose to provide a more solid experience between the native V8 C++ API and the V8 PHP API.
<?php $isolate = new \V8\Isolate(); $context = new \V8\Context($isolate); $source = new \V8\StringValue($isolate, "'Hello' + ', World!'"); $script = new \V8\Script($context, $source); $result = $script->Run($context); echo $result->ToString($context)->Value(), PHP_EOL;
which will output
Hello, World!. See how it's shorter and more readable than that C++ version?
And it also doesn't limit you from V8 API utilizing to implement more amazing stuff.
If you are also using Composer, it is recommended to add the php-v8-stub package as a dev-mode requirement. It provides skeleton definitions and annotations to enable support for auto-completion in your IDE and other code-analysis tools.
composer require --dev pinepain/php-v8-stubs
$ sudo add-apt-repository -y ppa:ondrej/php $ sudo add-apt-repository -y ppa:pinepain/php $ sudo apt-get update -y $ sudo apt-get install -y php7.0 php-v8 $ php --ri v8
OS X (homebrew)
$ brew tap homebrew/dupes $ brew tap homebrew/php $ brew install php70 $ brew install https://raw.githubusercontent.com/pinepain/packaging/master/homebrew/v8.rb $ brew install https://raw.githubusercontent.com/pinepain/packaging/master/homebrew/php70-v8.rb $ php --ri v8
For Ubuntu there is the pinepain/libv8-5.4 PPA. To install libv8:
$ sudo add-apt-repository -y ppa:pinepain/libv8-5.4 $ sudo apt-get update -y $ sudo apt-get install -y libv8-5.4-dev
For OS X there is the v8.rb homebrew formula. To install libv8:
$ brew install https://raw.githubusercontent.com/pinepain/packaging/master/homebrew/v8.rb
$ sudo add-apt-repository -y ppa:ondrej/php $ sudo apt-get update -y $ sudo apt-get install -y php7.0
For OS X there is the homebrew/homebrew-php tap with php70, php71 and a large variety extensions for them.
$ brew tap homebrew/homebrew-php $ brew install php70
Installing php-v8 from packages
For Ubuntu there is the pinepain/php-v8 PPA.
$ sudo add-apt-repository -y ppa:pinepain/php-v8 $ sudo apt-get update -y $ sudo apt-get install -y php-v8
$ brew install https://raw.githubusercontent.com/pinepain/packaging/master/homebrew/php70-v8.rb
Building php-v8 from sources
git clone https://github.com/pinepain/php-v8.git cd php-v8 phpize && ./configure && make make test
To install extension globally run
$ sudo make install
to be able to customize some tests make sure you have
variables_order = "EGPCS"in your php.ini
export DEV_TESTS=1allows to run tests that are made for development reasons (e.g. test some weird behavior or for debugging)
To prevent the test suite from asking you to send results to the PHP QA team do
To track memory usage you may want to use
lsofto see what shared object are loaded and
freeto display free and used memory in the system.
Copyright (c) 2015-2016 Bogdan Padalko <[email protected]>