我们如何构建自己的PHP静态可执行文件-51CTO.COM

介绍

static-php-cli 是一个用于构建静态编译的 PHP 二进制的工具，目前支持 Linux 和 macOS 系统。在本章节中，你将了解到如何使用 static-php-cli 构建独立的 php 程序。

编译环境

下面是架构支持情况⚙️ 代表支持 GitHub Action 构建，💻 代表支持本地构建，空代表暂不支持。

OS	x86_64	aarch64
macOS	⚙️ 💻	⚙️ 💻
Linux	⚙️ 💻	⚙️ 💻
Windows	⚙️ 💻
FreeBSD	💻	💻

其中，Linux 目前仅在 Ubuntu、Debian、Alpine 发行版测试通过，其他发行版未进行测试，不能保证编译成功。对于未经过测试的发行版，可以使用 Docker 等方式本地编译，避免环境导致的问题。

macOS 下支持 x86_64 和 Arm 两种架构，但在其中一个架构上编译的二进制无法直接在另一个架构上使用。Rosetta 2 不能保证 Arm 架构编译的程序可以完全运行在 x86_64 环境下。

Windows 目前只支持 x86_64 架构，不支持 32 位 x86、不支持 arm64 架构。

PHP 支持版本

目前，static-php-cli 对 PHP 7.4 ~ 8.3 版本是支持的，对于 PHP 7.4 及更早版本理论上支持，只需下载时选择早期版本即可。但由于部分扩展和特殊组件已对早期版本的 PHP 停止了支持，所以 static-php-cli 不会明确支持早期版本。我们推荐你编译尽可能新的 PHP 版本，以获得更好的体验。

本地构建

手动构建

本项目提供了一个 static-php-cli 的二进制文件，你可以直接下载对应平台的二进制文件，然后使用它来构建静态的 PHP。目前spc二进制支持的平台有 Linux 和 macOS。

使用以下命令从自托管服务器下载；

curl -fsSL -o spc https://dl.static-php.dev/static-php-cli/spc-bin/nightly/spc-linux-x86_64

更多版本：https://static-php.dev/zh/guide/manual-build.html。

赋予二进制可执行权限；

chmod +x ./spc

查看版本

./spc --version
static-php-cli 2.3.2

下载依赖包

使用命令bin/spc download可以下载编译需要的源代码，包括 php-src 以及依赖的各种库的源码。

仅下载要编译的扩展及依赖库（使用扩展名，包含可选库）；

./spc download --for-extensions=pcntl,zstd --with-php=8.2

图片

环境检查

如果你可以正常运行bin/spc但无法正常编译静态的 PHP 或依赖库，可以先运行bin/spc doctor检查系统自身是否缺少依赖。

./spc doctor

图片

如果提示以下错误，请使用sudo权限。

[11:12:22] [INFO] [EXEC] ./configure --disable-gcc-wrapper
Fix failed
Some check item are not fixed

cmake版本太低；

Checking if cmake version >= 3.18 ... cmake version is too low (3.10.2), please update it manually!
Some check items can not be fixed !

下载解压；

wget https://cmake.org/files/v3.22/cmake-3.22.5.tar.gz

tar -zxvf cmake-3.22.5.tar.gz

cd cmake-3.22.5

# 编译安装
./configure
make

sudo  make  install

图片

验证安装；

cmake --version
cmake version 3.22.5

CMake suite maintained and supported by Kitware (kitware.com/cmake).

重新检测，可以看出以下输出信息表示环境检查通过。

_        _   _                 _           
 ___| |_ __ _| |_(_) ___      _ __ | |__  _ __  
/ __| __/ _` | __| |/ __|____| '_ \| '_ \| '_ \ 
\__ \ || (_| | |_| | (_|_____| |_) | | | | |_) |
|___/\__\__,_|\__|_|\___|    | .__/|_| |_| .__/   v2.3.2
                             |_|         |_|    
Checking if current OS are supported ... Linux x86_64 ubuntu, supported
Checking if necessary tools are installed ... ok
Checking if musl-wrapper is installed ... ok
Checking if musl-cross-make is installed ... ok
Checking if cmake version >= 3.18 ... 3.22.5
Checking if necessary linux headers are installed ... ok
Doctor check complete !

编译 PHP

使用 build 命令可以开始构建静态 php 二进制，在执行bin/spc build命令前，务必先使用download命令下载资源，建议使用doctor检查环境。

./spc build pcntl,zstd --build-cli

图片

构建结果；

_        _   _                 _           
 ___| |_ __ _| |_(_) ___      _ __ | |__  _ __  
/ __| __/ _` | __| |/ __|____| '_ \| '_ \| '_ \ 
\__ \ || (_| | |_| | (_|_____| |_) | | | | |_) |
|___/\__\__,_|\__|_|\___|    | .__/|_| |_| .__/   v2.3.2
                             |_|         |_|    
[14:52:49] [INFO] Build OS:       Linux (x86_64)
[14:52:49] [INFO] Build SAPI:     cli
[14:52:49] [INFO] Extensions (2): pcntl,zstd
[14:52:49] [INFO] Libraries (1):  zstd
[14:52:49] [INFO] Strip Binaries: yes
[14:52:49] [INFO] Enable ZTS:     no
[14:52:49] [INFO] PHP Version:    8.2.22
[14:52:49] [NOTI] Build will start after 2s ...
[14:52:51] [NOTI] lib [pkg-config] already built
[14:52:51] [INFO] Building required library [zstd]
[14:52:51] [INFO] Entering dir: /home/www/build/source/zstd/build/cmake/build
[14:52:51] [INFO] [EXEC] cmake -DCMAKE_C_COMPILER=x86_64-linux-musl-gcc -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/ -DCMAKE_INSTALL_BINDIR=/bin -DCMAKE_INSTALL_LIBDIR=/lib -DCMAKE_INSTALL_INCLUDEDIR=/include -DCMAKE_TOOLCHAIN_FILE=/home/www/build/source/toolchain.cmake -DZSTD_BUILD_STATIC=ON -DZSTD_BUILD_SHARED=OFF ..
[14:52:53] [INFO] [EXEC] cmake --build . -j 2
[14:54:38] [INFO] [EXEC] make install DESTDIR=/home/www/build/buildroot
[14:54:39] [INFO] Patching library [zstd] pkgconfig
[14:54:39] [INFO] lib [zstd] setup success, took 107.47 s
[14:54:39] [INFO] Entering dir: /home/www/build/source/php-src
[14:54:39] [INFO] [EXEC] ./buildconf --force
[14:54:42] [INFO] Entering dir: /home/www/build/source/php-src
[14:54:42] [INFO] pcntl is using --enable-pcntl 
[14:54:42] [INFO] zstd is using --enable-zstd --with-libzstd="/home/www/build/buildroot"
[14:54:42] [INFO] [EXEC] LD_LIBRARY_PATH=/usr/local/musl/x86_64-linux-musl/lib ./configure --prefix= --with-valgrind=no --enable-shared=no --enable-static=yes --disable-all --disable-cgi --disable-phpdbg --enable-cli --disable-fpm --disable-embed --disable-micro --enable-pcntl --enable-zstd --with-libzstd="/home/www/build/buildroot" CFLAGS='' CPPFLAGS='-I/home/www/build/buildroot/include' LDFLAGS='-L/home/www/build/buildroot/lib' LIBS='-ldl -lpthread -lm' 
[14:55:02] [INFO] cleaning up
[14:55:02] [INFO] Entering dir: /home/www/build/source/php-src
[14:55:02] [INFO] [EXEC] make clean
[14:55:03] [INFO] building cli
[14:55:03] [INFO] Entering dir: /home/www/build/source/php-src
[14:55:03] [INFO] [EXEC] sed -i "s|//lib|/lib|g" Makefile
[14:55:03] [INFO] [EXEC] $SPC_CMD_PREFIX_PHP_MAKE EXTRA_CFLAGS='-g -Os -fno-ident -fPIE' EXTRA_LIBS='/home/www/build/buildroot/lib/libzstd.a  ' EXTRA_LDFLAGS_PROGRAM='-all-static' cli
[15:02:04] [INFO] Entering dir: /home/www/build/source/php-src/sapi/cli
[15:02:04] [INFO] [EXEC] strip --strip-all php
[15:02:04] [INFO] Deploying cli file
[15:02:04] [INFO] [EXEC] cp '/home/www/build/source/php-src/sapi/cli/php' '/home/www/build/buildroot/bin/'
[15:02:04] [INFO] running cli sanity check
[15:02:04] [INFO] [EXEC] /home/www/build/buildroot/bin/php -r "echo \"hello\";"
[15:02:04] [INFO] Build complete, used 554.717 s !
[15:02:04] [INFO] Static php binary path: /home/www/build/buildroot/bin/php
[15:02:04] [INFO] License path: /home/www/build/buildroot/license/

使用 PHP CLi

构建完成之后，会在当前目录buildroot/bin生产一个二进制文件php，可以直接分发和使用。

buildroot/bin$ tree -L 1
.
├── php
├── pkg-config
├── unzstd -> zstd
├── zstd
├── zstdcat -> zstd
├── zstdgrep
├── zstdless
└── zstdmt -> zstd

查看PHP版本；

/buildroot/bin$ ./php -v
PHP 8.2.22 (cli) (built: Aug  9 2024 23:01:57) (NTS)
Copyright (c) The PHP Group
Zend Engine v4.2.22, Copyright (c) Zend Technologies

已安装模块pcntl,zstd；

./php -m
[PHP Modules]
Core
date
hash
json
pcntl
pcre
random
Reflection
SPL
standard
zstd

[Zend Modules]

打包编译好的二进制文件

tar -czvf php-8.2.22-static-bin-x86_64.tar.gz /home/www/build/buildroot/bin/php

其他

重复构建、调试

如果你需要重复构建、调试，你可以删除buildroot/和source/两个目录，这样你可以从已下载的源码压缩包重新解压并构建：

# remove
rm -rf buildroot source
# build again
bin/spc build bcmath,curl,openssl,ftp,posix,pcntl --build-cli

构建多个版本的 PHP

如果你想构建多个版本的 PHP，且不想每次都重复构建其他依赖库，可以使用switch-php-version在编译好一个版本后快速切换至另一个版本并编译：

# switch to 8.3
bin/spc switch-php-version 8.3
# build
bin/spc build bcmath,curl,openssl,ftp,posix,pcntl --build-cli
# switch to 8.0
bin/spc switch-php-version 8.0
# build
bin/spc build bcmath,curl,openssl,ftp,posix,pcntl --build-cli

切换到7.4；

sudo ./spc switch-php-version 7.4
[sudo] password for www: 
Downloading PHP source...
Switched to PHP 7.4 successfully!

重新构建；

./spc build pcntl,zstd --build-cli
     _        _   _                 _           
 ___| |_ __ _| |_(_) ___      _ __ | |__  _ __  
/ __| __/ _` | __| |/ __|____| '_ \| '_ \| '_ \ 
\__ \ || (_| | |_| | (_|_____| |_) | | | | |_) |
|___/\__\__,_|\__|_|\___|    | .__/|_| |_| .__/   v2.3.2
                             |_|         |_|    
[01:22:00] [INFO] Build OS:       Linux (x86_64)
[01:22:00] [INFO] Build SAPI:     cli
[01:22:00] [INFO] Extensions (2): pcntl,zstd
[01:22:00] [INFO] Libraries (1):  zstd
[01:22:00] [INFO] Strip Binaries: yes
[01:22:00] [INFO] Enable ZTS:     no
[01:22:00] [INFO] PHP Version:    7.4.33
[01:22:00] [NOTI] Build will start after 2s ...

查看版本；

/home/www/build/buildroot/bin/php -v
PHP 7.4.33 (cli) (built: Aug 10 2024 09:30:26) ( NTS )
Copyright (c) The PHP Group
Zend Engine v3.4.0, Copyright (c) Zend Technologies