Skip to content

Build on Windows

Jump to bottom
Czarek Tomczak edited this page Mar 22, 2017 · 21 revisions

This page provides step by step instructions on how to build PHP Desktop Chrome from sources.

Table of Contents generated with DocToc

Requirements

These instructions are for building Chrome 57 branch ("phpdesktop-chrome57/" directory).

Requirements:

Download PHP Desktop sources

Clone git repository.

Download CEF sources / prebuilt binaries

If you would like to use CEF prebuilt binaries then go to Spotify Automated CEF Builds. You have to download CEF for the same branch and revision that phpdesktop uses. See phpdesktop-chrome57/cef/README.txt or appropriate. Look for CEF version in that file. In our case for phpdesktop-chrome57/ branch it is 3.2987.1596.gc2b4638 as of writing. Choose "Standard Distribution" binaries.

If you would like to build CEF from sources then see CEF Branches and building (external) wiki page.

Build cefclient and copy CEF files to phpdesktop

The CEF binaries downloaded from Spotify after extracting have the "cef_binary_3.2987.1596.gc2b4638_windows32" directory. From now on we will refer to this directory as "cef_binary/" directory.

  1. Install CMake 2.8.12.1 or newer from http://www.cmake.org/ . During installation choose an option to add cmake to user's PATH.
  2. Install Ninja from http://martine.github.io/ninja/ . Put ninja.exe in your PATH or copy it to the build/ directory you will be creating in next step.
  3. In "cef_binary/" create a "build" directory and enter it
  4. Execute "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\bin\vcvars32.bat" (with quotes) - this sets environment variables for VS2015 for current session - all further commands need to be executed in current command window
  5. Execute cmake -G "Ninja" -DCMAKE_BUILD_TYPE=Release -DUSE_SANDBOX=OFF ..
  6. Execute ninja cefclient
  7. Go to the "cef_binary/build/tests/cefclient/Release/" directory and run cefclient.exe to see if it works fine
  8. Create "phpdesktop-chrome57/Release/" directory and copy files and subdirectories from the "cef_binary/Release/" and "cef_binary/Resources/" directories. Exclude ".lib" files. You may also copy cefclient.exe and cefclient.pdb from the "cef_binary/build/cefclient/" directory.
  9. Copy "cef_binary/build/libcef_dll_wrapper/libcef_dll_wrapper.lib" and "cef_binary/Release/libcef.lib" to the "phpdesktop-chrome57/lib/Release/" directory.
  10. To clean the build directory just delete it. To only clean ninja build and keep cmake files intact type ninja -t clean cefclient. If you need DEBUG binaries re-run commands starting from step 6 with DCMAKE_BUILD_TYPE=Debug and replace any "Release" directories mentioned with a "Debug" directory.

If you're building with version of CEF different from README.txt (eg. upgrading to a newer CEF) then delete the "phpdesktop-chrome57/cef/include/" directory and copy the "cef_binary/include/" directory (ignore the "capi" subdirectory). Also overwrite "phpdesktop-chrome57/cef/README.txt" file with "cef_binary/README.txt".

Download PHP binaries

Go to http://windows.php.net/download/ and download PHP for "x86" and "Non Thread Safe". Extract it and put binaries in phpdesktop-chrome57/php/ directory.

If you want to support Windows XP download PHP 5.4 binaries and additionally move all DLL extensions from php/ext/ directory to the root php/ directory. See Issue #34 for why it needs to be done so. You will also have to create/modify php.ini and set extension_dir option:

extension_dir=./

Build phpdesktop-chrome project

  1. Go to phpdesktop-chrome57/ directory
  2. Open phpdesktop-chrome.sln file in Visual Studio
  3. Change configuration to Release
  4. Build phpdesktop-chrome project. This will generate Release/phpdesktop-chrome.exe executable.
  5. Run phpdesktop-chrome.exe executable
Clone this wiki locally