Skip to content

Latest commit

 

History

History
349 lines (239 loc) · 11.3 KB

compile-windows.md

File metadata and controls

349 lines (239 loc) · 11.3 KB

Table of contents

How to install PHP-GTK on Windows

  1. You will need install Visual C++ Redistributable;

  2. Download the last release for Windows of PHP-GTK;

  3. Extract it to root, to be like C:\PHP-GTK\php.exe;

  4. Create your first PHP script on Desktop called simple.php;

    <?php

Gtk::init();

$window = new \GtkWindow();
$window->show_all();

Gtk::main();

  5. Open cmd.exe and run your script;

    C:\PHP-GTK\php.exe Desktop\simple.php

How to Build PHP-GTK on Windows

Preparing Visual Studio;

  1. Determining the Visual Studio version

    First of all, you need to know what version of Visual Studio do you need. Go to URL https://windows.php.net/downloads/php-sdk/deps/series/ and see what version of PHP are compiled on what version of Visual Studio. For example, you can see that PHP 8.2 can be compiled on VS16 only, because the file called packages-8.2-vs16-x64-stable.txt

  2. Downloading and installing Visual Studio

    2.1. Using Visual Studio 2022

    Just download Visual Studio 2022 community, and install

    ON Visual Studio 2022 Installer, Just check "C++ Desktop Development"

    2.2 Using Visual Studio 2019

    For PHP 8.1, all you need is install VS16 too, wich are included on VS 2019. So you can download Visual Studio 2019 from here

    Open the installer, and install Visual Studio Community 2019 and "C++ Desktop Development"

    If when you are reading that you cannot install Visual Studio 2019, try to install the current version of C++ Desktop Development and after that, click in modify Visual Studio Community, and on Individual Componentes tab, look for Build Tools MSVC v142 and Windows 10 SDK.

Compiling PHP on Windows;

  1. Download SDK Binary Tools

    SDK Binary Tools is a various scripts that make work easy

    Download binary tools from https://github.com/php/php-sdk-binary-tools

  2. Create a folder to work with codes

    Create a folder like C:\php-dev to extract PHP SDK

  3. Prepare environment

    Open cmd.exe as admin, and go to c:\php-dev\php-sdk

    Run phpsdk-vs17-x64.bat to prepare PHP environment. If you are running vs16, change to phpsdk-vs16-x64.bat, and keeping follow this doc using vs16 instead vs17

    Build tree source dir running bin\phpsdk_buildtree phpdev

    This will create some folders like C:\php-dev\php-sdk\phpdev\vs17\x64

  4. Preparing the PHP source

    Now download the PHP source, if you want to use another versions, go to archives

    Extract the source code inside de C:\php-dev\php-sdk\phpdev\vs17\x64, and rename it to be like C:\php-dev\php-sdk\phpdev\vs17\x64\php-8.2.20-src

  5. Downloading dependencies

    Back to the cmd.exe opend, go to C:\php-dev\php-sdk\phpdev\vs17\x64\php-8.2.20-src, and run the command phpsdk_deps --update --branch master to download dependencies

  6. Build and compile PHP from source code

    Inside the source code C:\php-dev\php-sdk\phpdev\vs17\x64\php-8.2.20-src, run buildconf

    Now you can create the config running configure --disable-all --enable-cli --disable-zts. You may want to run configure --help to see options and what you need to enable

    So now you can build with nmake

    It will compile PHP on C:\php-gtk3\php-sdk\phpdev\vs17\x64\php-8.2.20-src\x64\Release. You can run x64\Release\php.exe -m to confirm that is working

Preparing PHP, PHP-CPP and PHP-GTK code;

  1. Preparing PHP-CPP

    This is the poor part of this processes, becase there is alot PR unmerged on this repo. So, what you need is verify this pull requests looking for changes to work on windows, and do some changes manualy. ex: clone repository, and look for PR to make that work on php 8.1 and look for PR to make this work on windows, and do some changes manualy

    After do the changes, put this code into folder that we are using to store sources, to be like C:\php-dev\php-cpp

    Important: you have to rename the "string.h" in the folder "zend" to "strings.h" - because there is a Problem when using Windows. And then you have to change all dependencies from #include "string.h" to #include "strings.h" - but not this <string> - otherwise you get problems with the standard windows header files.

  2. Preparing PHP-GTK

    Get the last source of php-gtk, and extract it on the same folder, to be like C:\php-dev\php-gtk3

  3. Preparing PHP

    Download the PHP binary of the same version of source code, if you want to use another versions, go to archives to get the binaries. Pay attention to versions with NTS (non-threaed safe) or with out NTS according with your configure options

    Extract it inside our working folder to be like C:\php-dev\php-8.1.14-nts-Win32-vs16-x64

Downloading GTK on windows;

  1. Download MSYS2

    Get the last version of MSYS2 and install it

  • Downloading libs

  1. Open MSYS2 bash and download the libs with commands

    $ pacman -S mingw-w64-x86_64-gtk3
$ pacman -S mingw-w64-x86_64-libglade
$ pacman -S mingw-w64-x86_64-gtksourceview3
$ pacman -S mingw-w64-x86_64-glade
$ pacman -S mingw-w64-x86_64-gdk-pixbuf2
$ pacman -S mingw-w64-x86_64-glib2

  2. Preparing the libs

    Copy the file C:\msys2\mingw64\lib\glib-2.0\include\glibconfig.h to the folder C:\msys2\mingw64\include\glib-2.0

Creating Visual Studio project;

  1. Creating project

    Open Visual Studio and Create a new project of type a Blank C++ project. You can add any name and any place to save the project

  2. Importing files

    Right click on project name, go to "Add" -> "Existing Item" and add all .cpp from PHP-CPP and PHP-GTK projects, or you can drag'n drop from explorer to Visual Studio, on project name. Import files:

    C:\php-dev\php-cpp\zend\*.cpp
C:\php-dev\php-cpp\common\*.cpp
C:\php-dev\php-gtk3\src\**\*.cpp
C:\php-dev\php-gtk3\*.cpp

    You will need to remove the files

    C:\php-dev\php-gtk3\src\Gtk\GtkosxApplication.cpp
C:\php-dev\php-gtk3\src\libwnck\*.cpp

  3. Configure VS project

    Rigth click on project name, and go to properties

    Configure to Release and x64 platform

    i. Under "General":

    • Configuration Type: as dynamic library (.dll)

    ii. Under "C/C++" -> "General"

    • Additional Include Directories:
    C:\php-gtk3\php-sdk\phpdev\vs17\x64\php-8.2.20-src
C:\php-gtk3\php-sdk\phpdev\vs17\x64\php-8.2.20-src\TSRM
C:\php-gtk3\php-sdk\phpdev\vs17\x64\php-8.2.20-src\Zend
C:\php-gtk3\php-sdk\phpdev\vs17\x64\php-8.2.20-src\main
C:\php-dev\php-cpp
C:\msys2\mingw64\include\libgladeui-2.0
C:\msys2\mingw64\include\harfbuzz
C:\msys2\mingw64\include\gtk-3.0
C:\msys2\mingw64\include\cairo
C:\msys2\mingw64\include\gtksourceview-3.0
C:\msys2\mingw64\include\glib-2.0
C:\msys2\mingw64\include\gdk-pixbuf-3.0
C:\msys2\mingw64\include\atk-1.0
C:\msys2\mingw64\include\pango-1.0
    • Warning Level: Turn Off All Warnings (/W0)
    • SDL checks: No (/sdl-)
    • Multi-processor Compilation: Yes (/MP)
    • Runtime Library: Multi-threaded (/MT)

    iii. Under "C/C++" -> "Language"

    • C++ Language Standard: ISO C++17 Standard (/std:c++17)
    • C Language Standard: ISO C/17 Standard (/std:c17)

    iv. Under "C/C++" -> "Preprocessor"

    • Preprocessor definitions:
    _WINDOWS
_WIN32
NDEBUG
ZEND_DEBUG=0
_CRT_SECURE_NO_WARNINGS
PHP_WIN32
ZEND_WIN32
_MSC_VER=1929  			(look the version of MSC)
PHP_COMPILER_ID="VS16" 	(look the version of vs code)
_CRT_NONSTDC_NO_DEPRECATE
_NOEXCEPT=noexcept
G_PLATFORM_WIN32
GIO_COMPILATION
BUILDING_PHPCPP
PHP_VERSION_ID=80114 	(Following your PHP version of choice, you can find on C:\php-gtk3\php-sdk\phpdev\vs17\x64\php-8.2.20-src\main\php_version.h)
GDK_PIXBUF_COMPILATION
GDK_COMPILATION
GTK_COMPILATION
GLIB_COMPILATION

    v. Under "Linker" -> "General"

    • Additional Library Directories:
    C:\php-dev\php-8.1.14-nts-Win32-vs16-x64\dev
C:\msys2\mingw64\lib

    vi. Under "Linker" -> "Input"

    • Additional Dependencies:
    libgtk-3.dll.a
libgobject-2.0.dll.a
libgio-2.0.dll.a
libgdk-3.dll.a
php8.lib				(pay attention to the version of lib inside C:\php-dev\php-8.1.14-nts-Win32-vs16-x64\dev)
libgdk_pixbuf-2.0.dll.a
libglib-2.0.dll.a
libgladeui-2.dll.a
libgtksourceview-3.0.dll.a
libpango-1.0.dll.a

  4. Build everything

    Now you can compile the solution. Go to Build menu and Build Solution

Running and packing;

  1. PHP-GTK3 extension

    After build without errors, on project folder will create Release\php-gtk3.dll file. Copy this to C:\php-dev\php-8.1.14-nts-Win32-vs16-x64\ext\php_php-gtk3.dll

    Rename file C:\php-dev\php-8.1.14-nts-Win32-vs16-x64\php.ini-develpment to C:\php-dev\php-8.1.14-nts-Win32-vs16-x64\php.ini

    Edit C:\php-dev\php-8.1.14-nts-Win32-vs16-x64\php.ini adding on end of file extension=php-gtk3

  2. Dependent libs

    Copy these files from C:\msys2\mingw64\bin to the root directory of your C:\php-dev\php-8.1.14-nts-Win32-vs16-x64 folder:

    libatk-1.0-0.dll
libbrotlicommon.dll
libbrotlidec.dll
libbz2-1.dll
libcairo-2.dll
libcairo-gobject-2.dll
libdatrie-1.dll
libepoxy-0.dll
libexpat-1.dll
libffi-8.dll
libfontconfig-1.dll
libfreetype-6.dll
libfribidi-0.dll
libgcc_s_seh-1.dll
libgdk-3-0.dll
libgdk_pixbuf-2.0-0.dll
libgio-2.0-0.dll
libgladeui-2-13.dll
libglib-2.0-0.dll
libgmodule-2.0-0.dll
libgobject-2.0-0.dll
libgraphite2.dll
libgtk-3-0.dll
libgtksourceview-3.0-1.dll
libharfbuzz-0.dll
libiconv-2.dll
libintl-8.dll
liblzma-5.dll
libpango-1.0-0.dll
libpangocairo-1.0-0.dll
libpangoft2-1.0-0.dll
libpangowin32-1.0-0.dll
libpcre2-8-0.dll
libpixman-1-0.dll
libpng16-16.dll
libthai-0.dll
libwinpthread-1.dll
libxml2-2.dll
zlib1.dll

  3. Fixing GTK icons and themes

    Copy these files from C:\msys2\mingw64\share to the root directory of your C:\php-dev\php-8.1.14-nts-Win32-vs16-x64\share folder

    Open cmd.exe and go to folder ``C:\msys2\mingw64\bin`

    Run command gdk-pixbuf-query-loaders.exe --update-cache to create a pixbuf cache

    Now copy C:\msys64\mingw64\lib\gdk-pixbuf-2.0 to C:\php-dev\php-8.1.14-nts-Win32-vs16-x64\lib\

  4. Running

    Now you are able to run php with gtk extension. Open cmd.exe and try C:\php-dev\php-8.1.14-nts-Win32-vs16-x64\php.exe -m

    Create your first PHP script on Desktop called simple.php;

    <?php

Gtk::init();

$window = new \GtkWindow();
$window->show_all();

Gtk::main();

    And run C:\php-dev\php-8.1.14-nts-Win32-vs16-x64\php.exe Desktop\simple.php