GitHub - crazywhalecc/static-php-cli: Build standalone portable PHP binaries on Linux, macOS, Windows, with PHP project together, with popular extensions included.
StaticPHP
StaticPHP is a powerful tool designed for building portable executables including PHP, extensions, and more.
Important
We are preparing to release v3, which will include a project rename from static-php-cli to StaticPHP. And this branch is for v3. For v2, please check the
. Please update your references and stay tuned for the official release.
Features
🐘 Support multiple PHP versions - PHP 8.1, 8.2, 8.3, 8.4, 8.5, 8.6 (pre-release)
👜 Build single-file PHP executable with zero dependencies
🍔 Build
self-extracting executables (combines PHP binary and source code into one file)
💊 Automatic build environment checker with auto-fix capabilities
⚡ Linux, macOS, Windows support
🔧 Easy to extend with vendor mode and custom registries
📚 Intelligent dependency management
📦 Self-contained spc executable for easy self-installation
🔥 Support 100+ popular
💾 UPX compression support (reduces binary size by 30-50%)
Single-file standalone php-cli:
Combine PHP code with PHP interpreter using phpmicro:
Quickstart
1. Download spc binary
# For Linux x86_64 curl -fsSL -o spc https://dl.static-php.dev/v3/spc-bin/nightly/spc-linux-x86_64 # For Linux aarch64 curl -fsSL -o spc https://dl.static-php.dev/v3/spc-bin/nightly/spc-linux-aarch64 # macOS x86_64 (Intel) curl -fsSL -o spc https://dl.static-php.dev/v3/spc-bin/nightly/spc-macos-x86_64 # macOS aarch64 (Apple) curl -fsSL -o spc https://dl.static-php.dev/v3/spc-bin/nightly/spc-macos-aarch64 # Windows (x86_64, win10 build 17063 or later, please install VS2022 first) curl.exe -fsSL -o spc.exe https://dl.static-php.dev/v3/spc-bin/nightly/spc-windows-x64.exeFor macOS and Linux, add execute permission first:
chmod +x ./spc2. Build Static PHP
First, create a craft.yml file and specify which extensions you want to include from
or
:
# PHP version support: 8.1, 8.2, 8.3, 8.4, 8.5, 8.6 (pre-release)php-version: 8.5# Put your extension list hereextensions: "apcu,bcmath,calendar,ctype,curl,dba,dom,exif,fileinfo,filter,gd,iconv,mbregex,mbstring,mysqli,mysqlnd,opcache,openssl,pcntl,pdo,pdo_mysql,pdo_sqlite,phar,posix,readline,redis,session,simplexml,sockets,sodium,sqlite3,tokenizer,xml,xmlreader,xmlwriter,xsl,zip,zlib"sapi: - cli - microdownload-options: parallel: 10Run command:
./spc craft # Output full console log ./spc craft -vvv3. Static PHP usage
Now you can copy binaries built by StaticPHP to another machine and run with no dependencies:
# php-cli buildroot/bin/php -v # phpmicro echo '<?php echo "Hello world!\n";' > a.php ./spc micro:combine a.php -O my-app ./my-app Documentation
The current README contains basic usage. For the complete feature set of StaticPHP, see
.
Direct Download
If you do not want to build yet or just want to test first, you can download example pre-compiled artifacts from
or from a self-hosted server.
We offer 2 types of extension sets for each PHP version:
gigantic: Includes as many extensions as possible, the binary size is about 100-150MB.
base: Only includes a few extensions used by StaticPHP itself, the binary size is about 10MB.
WIP
Build Online (using GitHub Actions)
When the direct-download binaries above cannot meet your needs, you can use GitHub Actions to easily build a statically compiled PHP while defining your own extension list.
Fork this repository.
Go to the Actions of the project and select CI.
Select Run workflow, fill in the PHP version you want to compile, the target type, and the list of extensions. (extensions comma separated, e.g. bcmath,curl,mbstring)
After waiting for the workflow to finish, open the corresponding run and download Artifacts.
If you enable debug, all logs will be output at build time, including compiled logs, for troubleshooting.
We are also planning to provide a reusable GitHub Actions workflow in the future, so that you can easily build static PHP in your own repository, without forking this project.
Contribution
If the extension you need is missing, you can create an issue. If you are familiar with this project, you are also welcome to initiate a pull request.
If you want to contribute documentation, please just edit in docs/.
Sponsor this project
You can sponsor me or my project from
. A portion of your donation will be used to maintain the static-php.dev server.
Special thanks to sponsors below:
provides core contributors with
Open-Source License
This project itself is licensed under MIT. Some newly added extensions and dependencies may originate from other projects. The headers of those source files may also include additional LICENSE and AUTHOR information.
Please use the bin/spc dump-license command to export the open source licenses used in the project after compilation, and comply with the corresponding project's LICENSE.