mirror of
https://github.com/phpv8/v8js.git
synced 2025-03-11 21:08:45 +00:00
Add build instructions for Windows
This commit is contained in:
Stefan Siegl
parent
7b435e30dc
commit
720945b4ef
125
README.Win32.md
Normal file
125
README.Win32.md
Normal file
@ -0,0 +1,125 @@
|
||||
V8Js on Windows
|
||||
===============
|
||||
|
||||
The V8Js PHP extension is primarily targeted at Unix platforms, especially
|
||||
GNU/Linux. However it is possible (and supported) to build on Windows, using
|
||||
Microsoft Visual Studio.
|
||||
|
||||
Building with MinGW or Cygwin is not officially supported; mainly since
|
||||
Google v8 does not support builds on Cygwin (and building it on Cygwin is
|
||||
currently broken).
|
||||
|
||||
Compared to installation on GNU/Linux it's way more tedious to install V8Js
|
||||
on Windows, since you need to compile PHP with all its dependencies beforehand.
|
||||
|
||||
The problem is that Google v8 requires (at least) Visual Studio 2013 as it
|
||||
uses certain C++11 features not available in Visual Studio 2012.
|
||||
|
||||
Unfortunately the [PHP for Windows](http://windows.php.net/) project still
|
||||
relies on either Visual Studio 2012 or Visual Studio 2008.
|
||||
It supplies pre-compiled binary archives of required dependencies, however also
|
||||
compiled with Visual Studio 2008 and 2012 only.
|
||||
|
||||
Since it is not compatible to link a v8 compiled with Visual Studio 2013 with
|
||||
a PHP interpreter compiled with Visual Studio 2012, you need to step up and
|
||||
compile PHP with Visual Studio 2013. This requires to compile dependencies as
|
||||
well, if you would like to use certain extensions or e.g. the Apache SAPI.
|
||||
|
||||
|
||||
Compiling v8
|
||||
------------
|
||||
|
||||
The Google v8 project already has excellent step-by-step guide on
|
||||
[how to build with gyp](https://code.google.com/p/v8-wiki/wiki/BuildingWithGYP).
|
||||
|
||||
As a short run through:
|
||||
|
||||
* Download and install Python (make sure it adds python.exe to PATH during install)
|
||||
from http://www.python.org/download/
|
||||
* Install Git from https://github.com/msysgit/msysgit/releases/download/Git-1.9.4-preview20140929/Git-1.9.4-preview20140929.exe
|
||||
* Install Subversion from http://sourceforge.net/projects/win32svn/files/latest/download
|
||||
|
||||
Then open a command prompt
|
||||
|
||||
```
|
||||
cd \
|
||||
git clone https://github.com/v8/v8.git
|
||||
cd v8
|
||||
svn co http://gyp.googlecode.com/svn/trunk build/gyp
|
||||
svn co https://src.chromium.org/chrome/trunk/deps/third_party/icu46 third_party/icu
|
||||
svn co http://src.chromium.org/svn/trunk/tools/third_party/python_26@89111 third_party/python_26
|
||||
svn co http://src.chromium.org/svn/trunk/deps/third_party/cygwin@66844 third_party/cygwin
|
||||
svn co http://googletest.googlecode.com/svn/trunk testing/gtest --revision 643
|
||||
svn co http://googlemock.googlecode.com/svn/trunk testing/gmock --revision 410
|
||||
|
||||
python build\gyp_v8 -Dcomponent=shared_library
|
||||
"\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\devenv.com" /build Release build/All.sln
|
||||
```
|
||||
|
||||
(alternatively `start build/all.sln` ... and build within the Visual Studio GUI)
|
||||
|
||||
|
||||
|
||||
Compiling PHP
|
||||
-------------
|
||||
|
||||
There [Build your own PHP on Windows](https://wiki.php.net/internals/windows/stepbystepbuild)
|
||||
guide on the PHP wiki. However it concentrates on Visual Studio 2008 and 2012.
|
||||
Since you need to use Visual Studio 2013 it doesn't apply very well.
|
||||
|
||||
This document concentrates on building V8Js for CLI SAPI (only). In order
|
||||
to enable more extensions you need to provide further dependencies, which may
|
||||
be more or less cumbersome to build with Visual Studio beforehand.
|
||||
|
||||
A quick run through:
|
||||
|
||||
* install 7Zip from http://downloads.sourceforge.net/sevenzip/7z920-x64.msi
|
||||
* create directory \php-sdk
|
||||
* Download http://windows.php.net/downloads/php-sdk/php-sdk-binary-tools-20110915.zip
|
||||
* ... and unpack to \php-sdk
|
||||
|
||||
Open "VS2013 x86 Native Tools Command Prompt"
|
||||
|
||||
```
|
||||
cd \php-sdk
|
||||
bin\phpsdk_setvars.bat
|
||||
bin\phpsdk_buildtree.bat phpdev
|
||||
|
||||
mkdir vc12
|
||||
mkdir vc12\x86
|
||||
mkdir vc12\x86\deps
|
||||
mkdir vc12\x86\deps\bin
|
||||
mkdir vc12\x86\deps\include
|
||||
mkdir vc12\x86\deps\lib
|
||||
```
|
||||
|
||||
* download PHP from http://php.net/get/php-5.5.18.tar.gz/from/a/mirror
|
||||
and unpack to below `\php-sdk\phpdev\vc12\x86`
|
||||
* from `\v8\build\Release\lib` copy `icui18n.lib`, `icuuc.lib` and `v8.lib`
|
||||
to deps\lib folder
|
||||
* from `\v8\include copy` all v8*.h files to deps\include folder
|
||||
|
||||
(still in "VS2013 x86 Native Tools Command Prompt")
|
||||
|
||||
```
|
||||
cd \php-sdk\phpdev\vc12\x86\php-5.5.18\
|
||||
|
||||
buildconf
|
||||
configure --disable-all --enable-cli --with-v8js
|
||||
nmake
|
||||
```
|
||||
|
||||
After nmake completes the php.exe is in Release_TS\ directory.
|
||||
|
||||
In order to try things out in place, copy over `icui18n.dll`, `icuuc.dll` and
|
||||
`v8.dll` file from `\v8\build\Release` folder to
|
||||
`\php-sdk\phpdev\vc12\x86\php-5.5.18\Release_TS\` first.
|
||||
|
||||
Then run
|
||||
|
||||
```
|
||||
php.exe -d extension=php_v8js.dll -d extension_dir=\php-sdk\phpdev\vc12\x86\php-5.5.18\Release_TS\
|
||||
```
|
||||
|
||||
Alternatively copy all stuff to c:\php\ (including the three DLL files from
|
||||
v8 build).
|
||||
Loading…
x
Reference in New Issue
Block a user