mirrors/phpv8
mirrors/phpv8
0
0
Fork 0
mirror of https://github.com/phpv8/v8js.git synced 2024-11-11 00:08:42 +00:00
Code Releases Activity

update build instructions

Browse Source
This commit is contained in:
Stefan Siegl 2024-09-21 00:15:10 +02:00
parent ff1b080d2c
commit d1af93e544
1 changed files with 36 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

48
README.Linux.md
View File

@ -3,16 +3,18 @@ V8Js on GNU/Linux
Installation of V8Js on GNU/Linux is pretty much straight forward. Installation of V8Js on GNU/Linux is pretty much straight forward.
The biggest hurdle actually is that you need a rather new V8 library. First you need to decide if you can go with a V8 library that is
However many distributions still ship the rusty version 3.14, published shipped with your GNU/Linux distribution or whether you would want
years ago. to compile V8 on your own.
This means that you usually need to compile V8 on your own before Many GNU/Linux distributions, for example Debian/Ubuntu, have
you can start to compile & install V8Js itself. recent V8 library versions installable, that are ready to be used.
In order to go with these, just `sudo apt-get install libv8-dev`
(or similar, as it fits your distribution).
It is recommended to install the V8 version for V8Js off your system's If you compile V8 on your own, it is recommended to install the V8
load path, so it doesn't interfere with the V8 library shipped with your version for V8Js off your system's load path, so it doesn't interfere
system's distribution. with the V8 library shipped with your system's distribution.
Snapshots Snapshots
@ -51,12 +53,34 @@ then you
`CPPFLAGS="-DV8_COMPRESS_POINTERS"` to the `./configure` call. `CPPFLAGS="-DV8_COMPRESS_POINTERS"` to the `./configure` call.
Sandbox
-------
V8 has optional sandbox support. You need to compile php-v8js with matching
configurations. If your V8 library was called with sandbox support, you
need to pass the `-DV8_ENABLE_SANDBOX` flag to the configure call.
By default V8 currently enables this feature.
Many GNU/Linux distributions currently seem to have sandbox feature turned
off however.
If you configure it the wrong way round, you'll get runtime errors like this,
as soon as php-v8js tries to initialize V8:
```
Embedder-vs-V8 build configuration mismatch. On embedder side sandbox is DISABLED while on V8 side it's ENABLED.
```
In order to compile V8 with sandbox support off, pass `v8_enable_sandbox=false`
to v8gen.py invocation.
Compile V8 5.6 and newer (using GN) Compile V8 5.6 and newer (using GN)
----------------------------------- -----------------------------------
``` ```
# Install required dependencies # Install required dependencies
sudo apt-get install build-essential curl git python libglib2.0-dev sudo apt-get install build-essential curl git python3 libglib2.0-dev
cd /tmp cd /tmp
@ -69,8 +93,8 @@ fetch v8
cd v8 cd v8
# (optional) If you'd like to build a certain version: # (optional) If you'd like to build a certain version:
git checkout 8.0.426.30 git checkout 12.0.267.36
gclient sync gclient sync -D
# Setup GN # Setup GN
tools/dev/v8gen.py -vv x64.release -- is_component_build=true use_custom_libcxx=false tools/dev/v8gen.py -vv x64.release -- is_component_build=true use_custom_libcxx=false
@ -101,7 +125,7 @@ cd /tmp
git clone https://github.com/phpv8/v8js.git git clone https://github.com/phpv8/v8js.git
cd v8js cd v8js
phpize phpize
./configure --with-v8js=/opt/v8 LDFLAGS="-lstdc++" CPPFLAGS="-DV8_COMPRESS_POINTERS" ./configure --with-v8js=/opt/v8 LDFLAGS="-lstdc++" CPPFLAGS="-DV8_COMPRESS_POINTERS -DV8_ENABLE_SANDBOX"
make make
make test make test
sudo make install sudo make install