PHP SDK

PHP SDK is a tool kit for Windows PHP builds

License

The PHP SDK itself and the SDK own tools are licensed under the BSD 2-Clause license. With the usage of the other tools, you accept the respective licenses.

Overview

The reworked SDK is compatible with PHP 7.0 and above. The compatibility with php-sdk-binary-tools-20110915.zip available from windows.php.net is kept. Though, some irrelevant tools was removed. Newer tools and workflows are now possible. The toolset consists on a mix of the hand written scripts, selected MSYS2 parts and standalone programs.

Requirements

• Visual C++ 2015 must be installed prior SDK usage.
• if Cygwin is installed, please read notes in the pitfalls section

Tools

SDK

• phpsdk_buildtree - initialize the development filesystem structure
• phpsdk_deps - check and handle dependency libraries
• phpsdk_version - show SDK version
• phpsdk_dllmap - create a JSON listing of DLLs contained in zip files
• starter scripts, named phpsdk-<crt>-<arch>

Other tools

• bison 3.0.2, re2c 0.15.3
• awk, gawk, sed, grep
• diff, diff3, patch
• md5sum, sha1sum, sha224sum, sha256sum, sha384sum, sha512sum
• 7za, zip, unzip, unzipsfx
• wget

Not included

These are not included with the PHP SDK, but might be useful for the compilation and other tasks. While Visual C++ is the only required, the others might enable some additional functionality. Care yourself about making them available on your system.

• Git - optional, useful for PHP source management
• Cppcheck - optional, used for static analysis
• clang - optional, useful for experimental builds and for static analysis
• ICC - optional, useful for experimental builds

Usage

Basic usage example

• git clone https://github.com/OSTC/php-sdk-binary-tools.git c:\php-sdk
• cd c:\php-sdk
• git checkout new_binary_tools
• either run or click on phpsdk-vc14-x64.bat in the SDK root
• cd to c:\php-sdk and click on phpsdk-vc14-x64.bat in the SDK root
• phpsdk_buildtree phpmaster
• git clone https://github.com/php/php-src.git && cd php-src, or fetch a zipball
• phpsdk_deps --update --branch master
• do the build, eg. buildconf && configure --enable-cli && nmake

TODO more extensive documentation on the wiki

Staying compatible with the older version of the SDK

• git clone https://github.com/OSTC/php-sdk-binary-tools.git c:\php-sdk
• follow the instructions on the PHP wiki page

Extending

The SDK tools are KISS and should be kept so. Basic tools are implemented as simple batch script. The minimalistic PHP is available for internal SDK purposes. It can be used, if more complexity is required. If you have an idea for some useful tool, please open a ticket or PR, so it can be discussed, implemented and added to the SDK.

Pitfalls

• SDK or PHP sources put into paths including spaces might cause issue.
• If Cygwin is installed, it might cause issues. If it's unavoidable, to have Cygwin on the same machine, ensure SDK preceeds it on the PATH.
• Tools, based on MSYS2, only accept paths with forward slashes.