## 介绍 static-php-cli 是一个用于构建静态编译的 PHP 二进制的工具，目前支持 Linux 和 macOS 系统。 在本章节中，你将了解到如何使用 static-php-cli 构建独立的 php 程序。 ## 编译环境[​](https://static-php.dev/zh/guide/#%E7%BC%96%E8%AF%91%E7%8E%AF%E5%A2%83) 下面是架构支持情况`⚙️` 代表支持 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 ``` 查看版本 ```ts ./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). ``` 重新检测，可以看出以下输出信息表示环境检查通过。 ```ts _ _ _ _ ___| |_ __ _| |_(_) ___ _ __ | |__ _ __ / __| __/ _` | __| |/ __|____| '_ \| '_ \| '_ \ \__ \ || (_| | |_| | (_|_____| |_) | | | | |_) | |___/\__\__,_|\__|_|\___| | .__/|_| |_| .__/ 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/`两个目录，这样你可以从已下载的源码压缩包重新解压并构建： ```ts # remove rm -rf buildroot source # build again bin/spc build bcmath,curl,openssl,ftp,posix,pcntl --build-cli ``` #### 构建多个版本的 PHP 如果你想构建多个版本的 PHP，且不想每次都重复构建其他依赖库，可以使用`switch-php-version`在编译好一个版本后快速切换至另一个版本并编译： ```ts # 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 ``` ## 命令生成器 文档：https://static-php.dev/zh/guide/cli-generator.html