PHPSAB - PHP Static Autobuilder

PHP Static Autobuilder is script that let you build static single PHP Embed SAPI application for Windows. It take care of download, compile and install PHP and all of its dependencies for you.

Warning!

Effin' Windows Defender don't like Embed SAPI. If you get a warning, ignore it. There is no Trojan Horse. All the code is open soure.

Prerequisites

• Windows 10 or newer
• Visual C++ 16.0 (Visual Studio 2019)
• Strawberry Perl
• Git

Install

1. Download the latest binary release.
2. Extract phpsab.exe in a simple path like "c:\php-sdk\phpsab.exe".
3. Open phpsab.exe by doubleclicking on it or run it by cmd.
4. Wait until all dependancies are downloaded and compiled.
5. See the "build" folder.

Configuration

You can create your own configuration in the "config/" folder.
Example:

[build]
target = "php-static.exe" ; Name of target exe file
bootstrap = "phpinfo" ; Bootstrap (see master/bootstrap folder)
clean = false ; Always performs a clean build

[extensions]

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; Windows legacy extensions ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

win32std = Yes ; Mandatory (for res:// stream protocol)
winbinder = Yes ; Windows Interface native support
wcli = Yes ; Windows CLI native support


;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; Windows built-in extensions ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

; ffi = Yes
; com_dotnet = Yes
; readline = Yes

For the full list of supported extensions, see config.full.ini

Usage

> phpsab <configname> [test | clean]

• configname: the filename of the configuration file without .ini
• test: (optional) to test your configuration without compiling PHP
• clean: (optional) to create a clean build

Costum matrix file

If you want to work with a costum matrix, copy the file "master/matrix.json" in the root folder. PHPSAB will check for offline matrix before scrap it from github.

Troubleshooting

If you get a compiling error, before opening an issue, try a clean build.

> phpsab configname clean

If the error persists, open an issue with the appropriate log file. Any issue without log file will be rejected.

How does it works

After building the static embed libraries, PHPSAB use them to create a very simple program that include the embed SAPI and execute the content of the resource "res:///PHP/RUN". The res stream protocol is provided by win32std extension. So that's where we put the PHP application bootstrap or the PHAR archive. Look at the "master/bootstrap" folder for simple examples.

Create standalone application

Once you have a functionnal static php, you have multiple options to create your standalone single file application.

• Phar-composer is a simple phar creation for any project managed via Composer.
• Embeder2 is a command line program to add resources to your .exe file.
• res_set() is a function provided by win32std extension to add resources to your .exe file. Example:

<?php
$release = __DIR__ . '\php-static.exe';
$contents = file_get_contents(__DIR__ . '\test.phar');
var_dump(res_set($release, 'PHP', 'RUN', $contents));

Winbinder + GD

PHPSAB contains a modified version of Winbinder with a lot of new features like drag & drop files, access WMI etc. Originaly, Winbinder uses Freeimage.dll to process images but PHPSAB now provide a bridge to use built-in static GD instead. Example:

<?php

// Create window and image frame
define('IDC_IMAGE', 1001);
$win = wb_create_window(null, AppWindow, 'GD Winbinder', WBC_CENTER, WBC_CENTER, 220, 220, 0x00000000, 0);
$frame = wb_create_control($win, Frame, '', 10, 10, 200, 200, IDC_IMAGE, 0x00000004, 0, 0);


// Load PNG image with GD
$im = imagecreatefrompng(__DIR__."\\gd-logo.png");

// Convert GD image into BITMAP24 matrix
$matrix = imagegetbitmap24($im);

// Get variable address
$ptr = wb_get_address($matrix);

// Create a WB Image with the BMP matrix
$img = wb_create_image(imagesx($im), imagesy($im), $ptr + GD_BITMAP24_HEADER, $ptr + GD_BITMAP24_BITS);

// Destroy GD image
imagedestroy($im);
unset($matrix);

// Apply the image to the image frame
wb_set_image($frame, $img);


// Main loop
wb_main_loop();

License

The scripts and documentation in this project are released under the MIT License